X Twitter MCP Server

What is X Twitter MCP Server about?

Enables users to compose tweets, build threads, handle drafts, publish, and delete posts on X/Twitter via conversational commands in Claude.

How to use X Twitter MCP Server?

1. Install the server:
   • Preferred: npx -y @smithery/cli install x-mcp --client claude
   • Manual: clone the repo, install uv (brew install uv), and run it with the provided configuration.
2. Configure Claude Desktop:
   • Create claude_desktop_config.json in the Claude data folder.
   • Add an entry under mcpServers that points to the server executable (see serverConfig below).
   • Insert your X/Twitter API keys, secret, access token, and token secret.
3. Restart Claude Desktop to load the new MCP server.
4. Interact with Claude using natural language, e.g., “Tweet ‘Hello world!’” or “Create a thread about the history of pizza.”

Key Features

• Direct tweet creation and publishing from Claude chat.
• Thread generation and draft management.
• Simple CLI execution via uv or Smithery installation.
• Environment‑based configuration of Twitter API credentials.
• Troubleshooting guidance for common setup issues.

Use Cases

• Social‑media managers automate daily posting without leaving Claude.
• Content creators quickly draft and schedule threaded stories.
• Developers embed Twitter actions into AI‑driven workflows and agents.
• Teams coordinate marketing campaigns through conversational interfaces.

FAQ

What credentials are required? You need the API key, API secret, access token, and access token secret from the X/Twitter Developer Portal.

Do I need to install UV? Yes, the manual setup runs the server with UV. Install it globally via Homebrew (brew install uv).

Can I use Smithery instead? Absolutely – the one‑line npx command installs and registers the server automatically.

Where do I place the configuration file?

• macOS: ~/Library/Application Support/Claude/
• Windows: %APPDATA%/Claude/

What if the server does not start? Verify UV is in your PATH, confirm the repository path in the config, and double‑check all API credentials.

X(Twitter) MCP server

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

Quick Setup

Installing via Smithery

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

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

Manual Installation

1. Clone the repository:

git clone https://github.com/yourusername/x-mcp.git

2. Install UV globally using Homebrew in Terminal:

brew install uv

3. 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

4. Add this configuration to claude_desktop_config.json:

{
  "mcpServers": {
    "x_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/x-mcp",
        "run",
        "x-mcp"
      ],
      "env": {
        "TWITTER_API_KEY": "your_api_key",
        "TWITTER_API_SECRET": "your_api_secret",
        "TWITTER_ACCESS_TOKEN": "your_access_token",
        "TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret"
      }
    }
  }
}

5. 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

6. Update the config file:

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

7. 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