Twitter Automation MCP Server

A Model Context Protocol (MCP) server that enables Claude to automate Twitter posting with AI-generated images and thread support.

Features

• 🎨 AI Image Generation - Generate images using Google AI Gemini 2.0 Flash
• 🔗 URL Image Support - Add images from URLs
• 🐦 Twitter Integration - Full Twitter API v2 support with media upload
• 🧵 Thread Support - Automatic thread creation with proper reply chains
• 📏 Length Validation - Prevents 280+ character tweets with clear error messages
• 🔄 Auto Upload - Images automatically upload when posting tweets

Quick Start

1. Install Package

npm install -g twitter-automation-mcp

2. Get API Keys

Twitter API Keys: Follow this guide to generate your Twitter API keys and tokens: 👉 [Generate Twitter API Keys & Tokens](https://www.ryancarmody.dev/blog/generate-twitter-api-keys-and-tokens)

Google AI API Key: Get your key from Google AI Studio

3. Configure Claude Desktop

Add to your Claude Desktop MCP config:

Option A: Using NPM Package (Recommended)

{
  "mcpServers": {
    "twitter-automation": {
      "command": "npx",
      "args": ["twitter-automation-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",
        "GOOGLE_AI_API_KEY": "your_google_ai_key"
      }
    }
  }
}

Option B: Using Local Installation

{
  "mcpServers": {
    "twitter-automation": {
      "command": "node",
      "args": ["path/to/twitter-automation/dist/index.js"],
      "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",
        "GOOGLE_AI_API_KEY": "your_google_ai_key"
      }
    }
  }
}

4. Restart Claude Desktop

Restart Claude Desktop to load the MCP server.

Usage

Simple Tweet

Post this tweet: "Hello world! 👋 #FirstTweet"

Tweet with AI-Generated Image

Generate an image of a robot coding, then post: "AI is the future! 🤖💻"

Tweet with URL Image

Add this image https://example.com/image.jpg then post: "Check this out!"

Twitter Thread

Post this tweet: "Here's what I learned about AI 🧵" 
With thread: ["First insight about machine learning", "Second point about neural networks"]

Thread with Images

Generate an image "AI brain" for the main tweet
Add URL image https://example.com/chart.jpg for thread tweet 1  
Then post the thread

Available Tools

• `generateImages` - Generate AI images for specific tweets in thread
• `addImageFromUrl` - Add existing images from URLs to specific tweets
• `postTweet` - Post tweets with automatic image upload and validation

Error Handling

The server provides clear error messages:

• Length validation: "Main tweet content is 287 characters, which exceeds the 275 character limit"
• Missing credentials: Clear indication of which API keys are missing
• Twitter API errors: Descriptive error messages with context

Requirements

• Node.js 18+
• Twitter Developer Account with Read & Write permissions
• Google AI Studio API access

Troubleshooting

"403 Forbidden" errors: Ensure your Twitter app has Read & Write permissions and regenerate access tokens after changing permissions.

"Image upload failed": Check that your images are valid PNG/JPG files under 5MB.

"Content too long": Each tweet must be under 275 characters. Split long content into thread tweets.

Deployment

Want to deploy this MCP server or run it in a container?

👉 See [DEPLOYMENT.md](DEPLOYMENT.md) for deployment options:

• NPM Package - Publish and use with npx (recommended)
• Docker Container - Run in isolated environment with full environment variable setup

License

MIT