Back to Blog

How to Schedule Tweets from Claude in 2 Minutes (Step-by-Step MCP Guide)

OpenTweet Team6 min read
How to Schedule Tweets from Claude in 2 Minutes (Step-by-Step MCP Guide)

How to Schedule Tweets from Claude in 2 Minutes (Step-by-Step MCP Guide)

Yes, you can schedule and publish tweets directly from Claude โ€” no browser tab switching, no Twitter API keys, and no code required.

All you need is the OpenTweet MCP server, which connects Claude (Desktop, Code, or any MCP client) to your Twitter/X account through natural conversation.

This guide walks you through the complete setup in under 2 minutes.

What You'll Be Able to Do

Once connected, just talk to Claude like you normally would:

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

Claude handles the rest โ€” creating the tweet, picking the right time slot, and scheduling it through OpenTweet.

Prerequisites

Before starting, you need two things:

  1. An OpenTweet account with a connected X/Twitter account โ€” sign up here (7-day free trial, no credit card required)
  2. An OpenTweet API key โ€” create one from your Developer Dashboard

That's it. No Twitter developer account needed. OpenTweet handles the X API connection for you.

Option 1: Claude Desktop Setup

Claude Desktop is the most popular MCP client. Here's how to connect it to Twitter.

Step 1: Open Your Claude Desktop Config

On macOS, open this file:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%\Claude\claude_desktop_config.json

If the file doesn't exist, create it.

Step 2: Add the OpenTweet MCP Server

Paste this into your config file:

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

Replace ot_your_key_here with your actual API key from the Developer Dashboard.

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop. You should see the OpenTweet tools available in the tools menu (the hammer icon).

Step 4: Start Scheduling

Type something like:

"Schedule a tweet saying 'Just shipped a new feature! ๐Ÿš€' for tomorrow at 10am"

Claude will use the OpenTweet MCP server to create and schedule the tweet. Done.

Option 2: Claude Code Setup

If you live in the terminal, Claude Code is the way to go.

Step 1: Add the MCP Server

Run this single command:

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

Step 2: Set Your API Key

export OPENTWEET_API_KEY="ot_your_key_here"

Or add it to your .bashrc / .zshrc for persistence.

Step 3: Start Using

Open Claude Code and ask it to schedule tweets while you code. Perfect for developers who want to share updates without context-switching.

Option 3: Cursor Setup

Cursor supports MCP servers through its settings.

Step 1: Open MCP Settings

Go to Cursor Settings โ†’ MCP โ†’ Add Server.

Step 2: Add the Config

Use the same configuration as Claude Desktop:

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

Step 3: Start Using

Ask Cursor's AI to schedule tweets while you code. It works exactly like Claude Desktop.

What Can You Do Once Connected?

The OpenTweet MCP server gives Claude 12 tools to work with:

What You Can Do Example Prompt
Create a tweet "Write a tweet about launching my new SaaS"
Schedule a tweet "Schedule this for tomorrow at 9am EST"
Create a thread "Create a 5-tweet thread about TypeScript tips"
Batch schedule "Schedule these 10 tweets across the next week"
Check analytics "How did my tweets perform this week?"
Get best times "When should I post for maximum engagement?"
View drafts "Show me my draft tweets"
Edit a tweet "Change the second tweet in my thread"
Publish immediately "Publish this draft right now"
Upload media "Attach this screenshot to the tweet"
Check followers "How has my follower count changed this month?"
Account status "How many scheduled tweets do I have left?"

Real Conversation Example

Here's what a typical interaction looks like:

You: "I just shipped a dark mode feature. Create a tweet thread about it โ€” mention the technical challenges and make it engaging."

Claude: Creates a 4-tweet thread using opentweet_create_thread:

  1. "Just shipped dark mode for our app. Took 3 weeks, broke everything twice, worth every minute. Here's what I learned ๐Ÿงต"
  2. "Challenge #1: CSS variables everywhere. We had 847 hard-coded colors. Solution: a Tailwind config revamp + a custom codemod that found them all in 20 minutes."
  3. "Challenge #2: Images. You can't just invert them. We built a smart detection system that identifies logos, screenshots, and photos โ€” each gets different treatment."
  4. "The result: 40% of users switched to dark mode in the first 24 hours. If you're building a SaaS, dark mode isn't optional anymore. Ship it."

You: "Nice, schedule it for Monday at 9am"

Claude: Schedules the thread for Monday 9am using opentweet_batch_schedule

You: "Also, what were my best performing tweets last week?"

Claude: Fetches analytics using opentweet_get_analytics and shows your top tweets by engagement

That's the workflow. Natural conversation, real results.

Troubleshooting

"Cannot find module @opentweet/mcp-server"

Make sure you have Node.js 18+ installed. Run node --version to check.

"OPENTWEET_API_KEY is required"

Double-check that your API key is set in the MCP config's env section. The key should start with ot_.

"API error: 401"

Your API key might be expired or invalid. Generate a new one from the Developer Dashboard.

"API error: 429"

You've hit the rate limit. Wait a minute and try again. Pro plans get 60 requests/minute.

Tools not showing in Claude Desktop

Make sure you restart Claude Desktop after editing the config file. The tools should appear in the hammer icon menu.

Why MCP Instead of the Twitter API Directly?

You might wonder why you need MCP when Twitter has its own API. Here's the difference:

  • No Twitter developer account needed โ€” OpenTweet handles the X API connection
  • No code required โ€” just talk to Claude in natural language
  • Built-in AI content generation โ€” Claude writes the tweets, not just schedules them
  • Analytics included โ€” ask about performance without opening another dashboard
  • Works across clients โ€” same setup works in Claude Desktop, Claude Code, Cursor, Windsurf, and more

Getting Started

  1. Sign up for OpenTweet (7-day free trial)
  2. Connect your X/Twitter account
  3. Create an API key
  4. Add the MCP server to your AI client (2 minutes)
  5. Start scheduling tweets from Claude

That's it. Your Twitter workflow just got a lot simpler.


OpenTweet's MCP server is open-source and available on npm. Works with any MCP-compatible AI client including Claude Desktop, Claude Code, Cursor, Windsurf, and VS Code with Copilot.

Start Scheduling Your X Posts Today

Join hundreds of creators using OpenTweet to stay consistent, save time, and grow their audience.

7-day free trial
Only $11.99/mo
Cancel anytime