twitter-mcp-server

Twitter client MCP Server where you only have to connect your account or auth token and let everything else be handled for you

Tools

Reading Tools

• get_tweets - Retrieve the latest tweets from a specific user
• get_profile - Access profile details of a user
• search_tweets - Find tweets based on hashtags or keywords

Interaction Tools

• like_tweet - Like or unlike a tweet
• retweet - Retweet or undo retweet
• post_tweet - Publish a new tweet, with optional media attachments

Timeline Tools

• get_timeline - Fetch tweets from various timeline types
• get_trends - Retrieve currently trending topics

User Management Tools

• follow_user - Follow or unfollow another user

Usage

Add the server config to your MCP client:

On MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--name", "twitter-mcp-server",
        "touchmeangel/twitter-mcp-server"
      ]
    }
  }
}

Or run http server like this

docker run -i --rm --name twitter-mcp-server -e APP_PORT=3000 -p 3000:3000 touchmeangel/twitter-mcp-server

You can even just run it inside docker compose

services:
  twitter-mcp:
    image: touchmeangel/twitter-mcp-server
    restart: unless-stopped
    environment:
      - APP_PORT=3000
    ports:
      - 3000:3000

Now use http://twitter-mcp:3000/mcp or http://localhost:3000/mcp for connection

Authentication

Authorization: Bearer <auth_token>:<ct0>

auth_token and ct0 are X (Twitter) cookies which allow access to your account.

Error Handling

The server implements comprehensive error handling:

• Input validation for all parameters
• Rate limiting protection
• Detailed error messages
• Proper error propagation
• Logging for debugging

Development & Testing

Contributions are welcome! Please feel free to submit a Pull Request.

To test tools use

npx @modelcontextprotocol/inspector