@opentweet/mcp-server

@opentweet/mcp-server

MCP server for OpenTweet — manage your Twitter/X presence from Claude, Cursor, or any AI assistant.

Quick Start

1. Get an API Key

Sign up at opentweet.io and create an API key from the Developer Dashboard.

2. Install

One-command setup (auto-detects Claude Code, Claude Desktop, Cursor, and Windsurf):

npx -y @opentweet/mcp-server --install --api-key ot_your_key_here

This will find all installed AI clients on your machine and configure them automatically. Restart your AI clients after running this.

Manual Setup

If you prefer to configure manually, add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "opentweet": {
      "command": "npx",
      "args": ["-y", "@opentweet/mcp-server"],
      "env": {
        "OPENTWEET_API_KEY": "ot_your_key_here"
      }
    }
  }
}

For Claude Code:

claude mcp add opentweet -- npx -y @opentweet/mcp-server

3. Start Using

Ask your AI assistant:

• "Schedule a tweet about React performance for tomorrow at 9am"
• "Show me my posting streak and analytics"
• "Create a 5-tweet thread about TypeScript tips"
• "What are my best posting times?"

Tools

Tool	Description
opentweet_create_tweet	Create a tweet (draft, scheduled, or publish now)
opentweet_create_thread	Create a multi-tweet thread (2-25 tweets)
opentweet_list_tweets	List tweets with status filters and pagination
opentweet_get_tweet	Get full details of a specific tweet
opentweet_update_tweet	Edit tweet text, category, schedule, or media
opentweet_delete_tweet	Delete a tweet
opentweet_publish_tweet	Publish a draft/scheduled tweet immediately to X
opentweet_batch_schedule	Schedule up to 50 tweets at once
opentweet_get_analytics	Get posting stats, streaks, trends, engagement
opentweet_get_followers	Get follower growth data over time
opentweet_get_account	Get account status, subscription, and limits
opentweet_upload_media	Upload images/videos for use in tweets

Resources

URI	Description
opentweet://account	Account status and limits
opentweet://posts/scheduled	Currently scheduled tweets
opentweet://posts/drafts	Draft tweets
opentweet://analytics/summary	Analytics overview

Prompts

Name	Description
weekly_content_plan	Generate a week of tweet content
review_and_schedule_drafts	Review drafts and suggest scheduling
content_from_url	Generate tweets from a URL or topic
performance_review	Analyze performance and get suggestions

Requirements

• Node.js 18+
• OpenTweet account with API key (get one here)
• Connected X/Twitter account in OpenTweet

Environment Variables

Variable	Required	Description
OPENTWEET_API_KEY	Yes	Your OpenTweet API key (starts with ot_)
OPENTWEET_BASE_URL	No	API base URL (default: https://opentweet.io)

Links

• OpenTweet
• MCP Server Feature Page
• Developer Dashboard
• API Documentation

License

MIT