X (Twitter)

What is x-mcp?

x-mcp is a server that enables direct interaction with X (formerly Twitter) for creating, managing, and publishing posts, all through the Claude chat interface. It acts as a bridge between your Claude AI assistant and your X/Twitter account, streamlining your social media workflow.

How to use x-mcp?

There are two primary ways to install and use x-mcp:

Installing via Smithery

For automatic installation with Claude Desktop, use the Smithery CLI:

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: brew install uv (for macOS)
3. Create claude_desktop_config.json: Located in ~/Library/Application Support/Claude/ (macOS) or %APPDATA%/Claude/ (Windows).
4. Add configuration: Populate the claude_desktop_config.json with the provided JSON structure, ensuring to replace /path/to/x-mcp with your actual repository path.
5. Obtain X/Twitter API credentials: Create a project in the X API Developer Portal with Read and Write permissions, Web App type, and set Callback URL to http://localhost/ and Website URL to http://example.com/. Copy all generated keys and tokens.
6. Update config file: Insert your X/Twitter API credentials into the claude_desktop_config.json.
7. Restart Claude: Fully quit and reopen Claude Desktop.

Key Features of x-mcp

• Direct X/Twitter posting: Create and publish tweets directly from Claude chat.
• Draft management: Save, view, and delete draft tweets.
• Thread creation: Compose and publish multi-tweet threads.
• Integration with Claude: Seamlessly integrates with Claude Desktop for a unified experience.

Use Cases of x-mcp

• Social media management: Efficiently manage your X/Twitter presence without leaving your AI chat interface.
• Content scheduling: Prepare and save tweets as drafts for future publication.
• Automated posting: Potentially integrate with Claude's capabilities for automated content generation and posting.
• Quick updates: Share real-time thoughts and updates on X/Twitter with minimal effort.

FAQ from x-mcp

Q: What if x-mcp is not working? A: Here are some troubleshooting steps:

• Ensure UV is installed globally. If not, try uninstalling (pip uninstall uv) and reinstalling (brew install uv).
• Verify the correct path to UV using which uv and update the command in your config if necessary.
• Double-check that all X/Twitter API credentials in your claude_desktop_config.json are accurate.
• Confirm that the x-mcp repository path in your configuration matches the actual location on your system.

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