# 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
```bash
# 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`:
```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
```dockerfile
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
