This MCP server allows Clients to interact with Twitter, enabling posting tweets and searching Twitter.
-
Create a Twitter Developer account and get your API keys from Twitter Developer Portal
-
Add this configuration to your Claude Desktop config file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"twitter-mcp": {
"command": "npx",
"args": ["-y", "@szdree/twitter-mcp"],
"env": {
"CLIENT_ID": "",
"CLIENT_SECRET": "",
"BEARER_TOKEN": "",
"ACCESS_TOKEN": "",
"REFRESH_TOKEN": ""
}
}
}
}- Restart Claude Desktop
That's it! Claude can now interact with Twitter through two tools:
post_tweet: Post a new tweetsearch_tweets: Search for tweets
Try asking Claude:
- "Can you post a tweet saying 'Hello from Claude!'"
- "Can you search for tweets about Claude AI?"
Logs can be found at:
- Windows:
%APPDATA%\Claude\logs\mcp-server-twitter.log - macOS:
~/Library/Logs/Claude/mcp-server-twitter.log
- Make sure your
BEARER_TOKENis valid and correctly configured - Twitter API v2 searching requires elevated access for certain endpoints
- Check log files for specific error messages
- Keep in mind that Twitter's free tier has rate limits for search API
Copy the .env.example file to .env and fill in your credentials:
cp .env.example .envThen edit the .env file with your Twitter API credentials.
If you want to contribute or run from source:
- Clone the repository:
git clone https://github.com/szdree/twitter-mcp.git
cd twitter-mcp- Install dependencies:
npm install- Build:
npm run build- Run:
npm startMIT