nuxe/twitter-mcp-server

Twitter MCP Server

A minimal Python MCP server for X (Twitter) with 3 core tools. Built for the free tier (100 reads, 500 posts/month).

Features

• get_home_timeline - Read your timeline
• create_tweet - Post new tweets
• reply_to_tweet - Reply to tweets

Setup

1. Install Dependencies

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Get Twitter API Credentials

1. Go to https://developer.twitter.com/
2. Create a Twitter Developer account
3. Create a new app
4. Get your credentials from the "Keys and Tokens" tab:
   • API Key
   • API Secret
   • Access Token
   • Access Token Secret
   • Bearer Token

3. Configure Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "twitter": {
      "command": "python",
      "args": ["/absolute/path/to/twitter-mcp-server/server.py"],
      "env": {
        "TWITTER_API_KEY": "your_actual_api_key",
        "TWITTER_API_SECRET": "your_actual_api_secret", 
        "TWITTER_ACCESS_TOKEN": "your_actual_access_token",
        "TWITTER_ACCESS_TOKEN_SECRET": "your_actual_access_token_secret",
        "TWITTER_BEARER_TOKEN": "your_actual_bearer_token"
      }
    }
  }
}

Important: Replace the placeholder values with your actual Twitter API credentials.

4. Restart Claude Desktop

After configuration, restart Claude Desktop to load the MCP server.

Usage

Once configured, you can use these tools in Claude:

• Read Timeline: "Show me my recent tweets from Twitter"
• Post Tweet: "Tweet 'Hello from Claude!' to Twitter"
• Reply to Tweet: "Reply to tweet ID 1234567890 with 'Great point!'"

Rate Limits

This server is designed for Twitter's free tier:

• 100 reads per month
• 500 posts per month

Tech Stack

• Python 3.10+
• MCP SDK
• Tweepy (Twitter API v2)