ayush-oswal/twitter-automation

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 Dependencies

npm install

2. Get API Keys

Twitter API Keys: Follow this guide to generate your Twitter API keys and tokens: 👉 Generate Twitter API Keys & Tokens

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

3. Configure Environment

cp env.example .env

Edit .env with your credentials:

TWITTER_API_KEY=your_twitter_api_key
TWITTER_API_SECRET=your_twitter_api_secret  
TWITTER_ACCESS_TOKEN=your_twitter_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_twitter_access_token_secret
GOOGLE_AI_API_KEY=your_google_ai_api_key
IMAGE_STORAGE_PATH=./images

4. Build & Configure

npm run build

Add to your Claude Desktop MCP config:

{
  "mcpServers": {
    "twitter-automation": {
      "command": "node",
      "args": ["path/to/twitter-automation/dist/index.js"]
    }
  }
}

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.

License

MIT