Awesome
X(Twitter) MCP server
An MCP server to create, manage and publish X/Twitter posts directly through Claude chat.
Quick Setup
- Clone the repository:
git clone https://github.com/yourusername/x-mcp.git
- Install UV globally using Homebrew in Terminal:
brew install uv
-
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
- For MacOS: Open directory
-
Add this configuration to claude_desktop_config.json:
{
"mcpServers": {
"x_mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/x-mcp",
"run",
"x-mcp"
],
"env": {
"TWITTER_API_KEY": "your_api_key",
"TWITTER_API_SECRET": "your_api_secret",
"TWITTER_ACCESS_TOKEN": "your_access_token",
"TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret"
}
}
}
}
-
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 tohttp://example.com/
- Generate and copy all keys and tokens from Keys and Tokens section
-
Update the config file:
- Replace
/path/to/x-mcp
with your actual repository path - Add your X/Twitter API credentials
- Replace
-
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 withbrew 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