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: ```bash ~/Library/Application Support/Claude/claude_desktop_config.json ``` On Windows: ```bash %APPDATA%/Claude/claude_desktop_config.json ``` Configuration: ```json { "mcpServers": { "twitter-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "--name", "twitter-mcp-server", "touchmeangel/twitter-mcp-server" ] } } } ``` <b>Or run http server like this</b> ```bash docker run -i --rm --name twitter-mcp-server -e APP_PORT=3000 -p 3000:3000 touchmeangel/twitter-mcp-server ``` <b>You can even just run it inside docker compose</b> ```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 ```bash npx @modelcontextprotocol/inspector ```