twitter-mcp-server

touchmeangel/twitter-mcp-server

3.3

If you are the rightful owner of twitter-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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

Tools
11
Resources
0
Prompts
0

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

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