twitter-voice-mcp

An MCP server that generates tweets in your unique voice and manages drafts for Twitter/X.

Features

• Voice Analysis: Analyze your Twitter/X voice from existing tweets or custom text
• AI-Powered Tweet Generation: Generate new tweets in your voice about any topic
• Draft Management: Create, review, and post tweet drafts
• Retweet Drafts: Generate voice-aligned comments for quote tweeting
• Image Tweet Generation: Automatically generate tweets for images in a folder
• Multi-AI Support: Works with Gemini, OpenAI, or Anthropic models

Installation

Prerequisites

• Python 3.10+
• Twitter/X API credentials (Bearer Token)
• AI API key (Gemini, OpenAI, or Anthropic)

Setup

# Clone and navigate to directory
git clone <repo-url> twitter-voice-mcp
cd twitter-voice-mcp

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Copy env template and add your credentials
cp .env.example .env
# Edit .env with your API keys

Environment Variables

GEMINI_API_KEY=your-gemini-key
OPENAI_API_KEY=your-openai-key
ANTHROPIC_API_KEY=your-anthropic-key
TWITTER_BEARER_TOKEN=your-twitter-bearer-token

MCP Client Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twitter-voice-mcp": {
      "command": "python",
      "args": [
        "/absolute/path/to/twitter-voice-mcp/src/server.py"
      ],
      "env": {
        "GEMINI_API_KEY": "your-key",
        "TWITTER_BEARER_TOKEN": "your-token"
      }
    }
  }
}

Docker

FROM python:3.14-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY src /app/src
CMD ["python", "src/server.py"]

Available Tools

• configure_ai_model - Set AI provider and model
• analyze_my_voice - Analyze voice from tweets
• import_voice_profile - Import pre-analyzed profile
• analyze_from_file - Analyze voice from text file
• generate_draft_tweets - Generate tweets on a topic
• generate_retweet_drafts - Generate quote tweet comments
• list_pending_drafts - View all draft tweets
• approve_and_post_draft - Post approved draft to Twitter
• export_drafts_csv - Export drafts to CSV
• scan_and_draft_tweets_from_images - Auto-generate tweets from images

License

MIT