X(Twitter) MCP Server

X(Twitter) MCP server

An MCP server to create, manage and publish X/Twitter posts directly through Claude chat.

Quick Setup

Installing via Smithery

To install X(Twitter) MCP Server for Claude Desktop automatically via Smithery:

Manual Installation

1. Clone the repository:

2. Install UV globally using Homebrew in Terminal:

3. Create claude_desktop_config.json:
   • For MacOS: Open directory ~/Library/Application Support/Claude/ and create the file inside it
   • For Windows: Open directory %APPDATA%/Claude/ and create the file inside it
4. Add this configuration to claude_desktop_config.json:

5. Get your X/Twitter API credentials:
   • Go to X API Developer Portal
   • Create a project
   • In User Authentication Settings: Set up with Read and Write permissions, Web App type
   • Set Callback URL to http://localhost/ and Website URL to http://example.com/
   • Generate and copy all keys and tokens from Keys and Tokens section
6. Update the config file:
   • Replace /path/to/x-mcp with your actual repository path
   • Add your X/Twitter API credentials
7. Quit Claude completely and reopen it

Usage Examples

• "Tweet 'Just learned how to tweet through AI - mind blown! 🤖✨'"
• "Create a thread about the history of pizza"
• "Show me my draft tweets"
• "Publish this draft!"
• "Delete that draft"

Troubleshooting

If not working:

• Make sure UV is installed globally (if not, uninstall with pip uninstall uv and reinstall with brew install uv)
• Or find UV path with which uv and replace "command": "uv" with the full path
• Verify all X/Twitter credentials are correct
• Check if the x-mcp path in config matches your actual repository location