Twitter Mcp Server

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

```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` 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
```bash
npx @modelcontextprotocol/inspector

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: touchmeangel
• Source: touchmeangel/twitter-mcp-server
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.