touchmeangel/twitter-mcp-server
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.
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 userget_profile
- Access profile details of a usersearch_tweets
- Find tweets based on hashtags or keywords
Interaction Tools
like_tweet
- Like or unlike a tweetretweet
- Retweet or undo retweetpost_tweet
- Publish a new tweet, with optional media attachments
Timeline Tools
get_timeline
- Fetch tweets from various timeline typesget_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