How to add Twitter MCP to Claude Desktop
Post tweets and search Twitter/X from Claude or any MCP client using your Twitter API keys. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 14, 2026 · 401★ · stdio · apikey
Claude Desktop config for Twitter MCP
npx -y @enescinar/twitter-mcp{
"mcpServers": {
"twitter-mcp": {
"command": "npx",
"args": [
"-y",
"@enescinar/twitter-mcp"
],
"env": {
"API_KEY": "<your-api-key>",
"API_SECRET_KEY": "<your-api-secret-key>",
"ACCESS_TOKEN": "<your-access-token>",
"ACCESS_TOKEN_SECRET": "<your-access-token-secret>"
}
}
}
}Setup steps
- 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the Twitter MCP config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm Twitter MCP's tools appear under the 🔌 tools menu.
Before you start
- A Twitter/X developer account with an app created in the Developer Portal
- Four credentials from that app: API key, API secret key, access token, access token secret (with write permission for posting)
- Node.js with npx; an X API tier that includes the endpoints you need (search usually requires a paid tier)
What Twitter MCP can do in Claude Desktop
post_tweetPost a new tweet as the authenticated account.
search_tweetsSearch for tweets matching a query.
Security
The four credentials in your config can post as your account — use a dedicated X developer app with the narrowest permissions you can, and remember they sit in plain text in claude_desktop_config.json. The project has not seen a commit since July 2025, so factor in unpatched drift against X API changes.
Twitter MCP + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Twitter MCP config there under the "mcpServers" key and restart the client.
Is Twitter MCP safe to use with Claude Desktop?
The four credentials in your config can post as your account — use a dedicated X developer app with the narrowest permissions you can, and remember they sit in plain text in claude_desktop_config.json. The project has not seen a commit since July 2025, so factor in unpatched drift against X API changes.
Is twitter-mcp free to use?
The server is MIT-licensed and free, but the X API behind it is not: free-tier apps get only a small monthly posting quota and essentially no search access, so search_tweets usually requires the paid Basic tier or higher. Costs come from X, not the server.
Can it post threads, images, or read my timeline?
No — the README documents exactly two tools: post_tweet (plain-text tweets) and search_tweets. Threads, media uploads, DMs, timelines, and deletes are all out of scope; you would need a more full-featured X server for those.
Is the project still maintained?
Activity has stalled: the last commit was July 2025. It still works against the current X API as of this writing, but if X changes endpoints or auth, fixes would likely come from forks rather than upstream — worth knowing before building anything durable on it.