Opentweet MCP server

OpenTweet MCP Server

Post, schedule, and thread on X (Twitter) from Claude, Cursor, ChatGPT, Windsurf, or any MCP client. 30 tools covering tweets, threads, scheduling, an evergreen queue, analytics, AI media generation, and multi-account management.

No X developer account, no OAuth app setup, no pay-per-call API billing. OpenTweet owns the X connection; your agent gets simple tools.

Quick start: hosted server (recommended)

Nothing to install. Point your MCP client at the hosted Streamable HTTP endpoint:

https://mcp.opentweet.io/mcp

Claude Code, one command:

claude mcp add --transport http opentweet \
  https://mcp.opentweet.io/mcp \
  --header "Authorization: Bearer ot_your_api_key"

Or any MCP client config (Claude, Cursor, Windsurf, ChatGPT connectors):

{
  "mcpServers": {
    "opentweet": {
      "type": "streamable-http",
      "url": "https://mcp.opentweet.io/mcp",
      "headers": { "Authorization": "Bearer ot_your_api_key" }
    }
  }
}

Get your API key (prefix ot_) at opentweet.io/developer. Connect your X account once in the dashboard; the key covers everything else.

Other install options

Claude Desktop extension (one click)

Download the .mcpb extension from opentweet.io/claude-desktop and double-click it. Your API key is stored in the OS keychain.

Local via npm

npx -y @opentweet/mcp-server install   # interactive installer, detects your client

Or add manually:

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

Config file locations:

• Claude Desktop: ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows)
• Cursor: ~/.cursor/mcp.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json

The 30 tools

Tweets and threads createtweet, createthread, listtweets, gettweet, updatetweet, deletetweet, publishtweet, scheduletweet, batchschedule (up to 50 at once), repurposetweet

Media and AI generation uploadmedia, generateimage, generate_video

Analytics and insights getanalytics, gettopposts, getprofilegrowth, getbesttimes, analyzebesttimes, getcontentgaps, searchinspiration

Account getaccount, listaccounts (multi-account: pass xaccountid to any tool)

Evergreen queue getevergreensettings, updateevergreensettings, listevergreenposts, getevergreenpost, addtoevergreen, updateevergreenpost, removefromevergreen, getevergreenhistory

Plus MCP resources (account status, scheduled queue) and built-in prompts.

Example prompts

• "Write 3 tweets about TypeScript tips and schedule them across this week at my best posting times."
• "Turn this blog post into a thread and schedule it for tomorrow 9am."
• "What were my top 5 tweets this month? Add the best one to my evergreen queue."
• "Check my posting streak and content gaps, then draft tweets to fill them."

How it compares

X's official MCP server (XMCP) exposes the raw X API and can post, but it requires an X developer account, OAuth app credentials, and pay-per-use API billing, and it has no scheduling. OpenTweet is the managed publishing layer: flat pricing from $11.99/month, scheduling, threads, evergreen recycling, and analytics included. Full comparison: opentweet.io/mcp/post-to-x.

Links

Shortened. The full README is on GitHub.