What is X (Twitter)

The X(Twitter) MCP server is a tool designed to facilitate the creation, management, and publishing of posts on X (formerly Twitter) through Claude chat. It simplifies the interaction with the X API by providing direct commands for tweeting and managing drafts.

Use cases

Users can employ the X(Twitter) MCP server to tweet, create threads, manage draft tweets, and perform actions like publishing or deleting drafts. This is especially beneficial for content creators, marketers, and businesses looking to streamline their social media engagement.

How to use

To use the server, individuals can either install it automatically via Smithery or manually by cloning the repository and configuring the necessary settings. After obtaining X API credentials and setting up the configuration file, users interact with Claude chat using specific commands to manage their Twitter posts.

Key features

Key features include the ability to post tweets, create thread discussions, view and manage draft tweets, and easily publish or delete drafts. It leverages the capabilities of the X API for seamless social media interactions.

Where to use

This server is ideal for anyone using Claude Desktop, particularly those who wish to enhance their Twitter presence through automated and streamlined posting. It can be used in any environment that supports Claude, specifically focusing on social media management.

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