MCP Now
X (Twitter)

X (Twitter)

by vidhupv
GitHub

(by vidhupv) - Create, manage and publish X/Twitter posts directly through Claude chat.

create
install
path
server
repository

X(Twitter) MCP server

smithery badge

An MCP server to create, manage and publish X/Twitter posts directly through Claude chat.

X(Twitter) Server MCP server

Quick Setup

Installing via Smithery

To install X(Twitter) MCP Server for Claude Desktop automatically via Smithery:

1npx -y @smithery/cli install x-mcp --client claude

Manual Installation

  1. Clone the repository:
1git clone https://github.com/yourusername/x-mcp.git
  1. Install UV globally using Homebrew in Terminal:
1brew install uv

  1. Create claude_desktop_config.json:

    • For MacOS: Open directory ~/Library/Application Support/Claude/ and create the file inside it
    • For Windows: Open directory %APPDATA%/Claude/ and create the file inside it

  2. Add this configuration to claude_desktop_config.json:

1{
2  "mcpServers": {
3    "x_mcp": {
4      "command": "uv",
5      "args": [
6        "--directory",
7        "/path/to/x-mcp",
8        "run",
9        "x-mcp"
10      ],
11      "env": {
12        "TWITTER_API_KEY": "your_api_key",
13        "TWITTER_API_SECRET": "your_api_secret",
14        "TWITTER_ACCESS_TOKEN": "your_access_token",
15        "TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret"
16      }
17    }
18  }
19}

  1. Get your X/Twitter API credentials:

    • Go to X API Developer Portal
    • Create a project
    • In User Authentication Settings: Set up with Read and Write permissions, Web App type
    • Set Callback URL to http://localhost/ and Website URL to http://example.com/
    • Generate and copy all keys and tokens from Keys and Tokens section

  2. Update the config file:

    • Replace /path/to/x-mcp with your actual repository path
    • Add your X/Twitter API credentials

  3. Quit Claude completely and reopen it

Usage Examples

  • "Tweet 'Just learned how to tweet through AI - mind blown! 🤖✨'"
  • "Create a thread about the history of pizza"
  • "Show me my draft tweets"
  • "Publish this draft!"
  • "Delete that draft"

Troubleshooting

If not working:

  • Make sure UV is installed globally (if not, uninstall with pip uninstall uv and reinstall with brew install uv)
  • Or find UV path with which uv and replace "command": "uv" with the full path
  • Verify all X/Twitter credentials are correct
  • Check if the x-mcp path in config matches your actual repository location