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