
How to Post to Twitter from Claude Desktop with MCP (2026 Guide)
Claude Desktop is great for writing, research, and analysis. But it can also manage your entire Twitter presence -- scheduling tweets, creating threads, checking analytics, and running your evergreen queue -- all through natural conversation.
The missing piece is an MCP server that connects Claude to Twitter. That's what the OpenTweet MCP server does. Once you set it up, you can tell Claude to schedule a tweet and it actually schedules it. Ask it to create a thread and it creates a real thread on your X account. No browser tabs, no copy-pasting, no context switching.
This guide walks through the complete setup from scratch, shows you what you can do once connected, and covers the common issues people run into.
What You'll Be Able to Do
After setup, you can talk to Claude in plain English and it handles the Twitter side:
- Schedule tweets and threads for any date and time without opening Twitter
- Generate AI content and post it directly -- Claude writes the tweet and schedules it in one step
- Manage your evergreen queue -- add your best tweets to an auto-recycling pool that reposts them on rotation
- View analytics and performance -- check your posting streaks, best times, and trends
- Handle multiple X accounts -- if you manage more than one account, target any of them by name
The entire workflow happens inside the Claude Desktop chat window. You type what you want, Claude does it.
Prerequisites
Before you start, make sure you have these three things:
- Claude Desktop installed -- Download it from claude.ai/download if you haven't already. Available for macOS and Windows.
- An OpenTweet account with an API key -- Sign up at opentweet.io (7-day free trial, no credit card required), connect your X/Twitter account, then generate an API key from your Developer Dashboard.
- Node.js 18+ installed -- Open a terminal and run
node --versionto check. If you don't have it, download it from nodejs.org.
You do not need a Twitter developer account. OpenTweet handles the X API connection for you.
Step 1: Get Your OpenTweet API Key
If you don't have an OpenTweet account yet:
- Go to opentweet.io and sign up. The 7-day free trial gives you full access to everything.
- Connect your X/Twitter account through the dashboard. This is a one-time OAuth flow -- you click "Connect X Account," authorize in Twitter, and you're done.
- Navigate to the Developer page from your dashboard.
- Click "Generate API Key." Your key starts with
ot_and looks something likeot_abc123def456. - Copy the key and save it somewhere safe. You'll paste it into the config file in the next step.
API access is included on all OpenTweet plans, starting at $11.99/month.
Step 2: Configure the MCP Server
There are three ways to set this up. Pick whichever feels most comfortable.
Method A: One-Click Install (Recommended)
This is the simplest option. No terminal, no config files.
- Go to opentweet.io/claude-desktop and download the Claude Desktop Extension (
.mcpbfile). - Double-click the downloaded file. Claude Desktop opens an install dialog showing the extension name and the 18 tools it provides.
- Click "Install" and enter your OpenTweet API key when prompted.
- Your API key is stored in your operating system's native keychain (macOS Keychain or Windows Credential Manager), not in a plaintext file.
That's it. Skip to Step 3.
Method B: Interactive Installer
If you prefer the terminal but want a guided experience, run this command:
npx -y @opentweet/mcp-server install
The installer walks you through adding the MCP server to your Claude Desktop config. It detects your operating system, finds the config file, and writes the correct entry. You just paste your API key when asked.
Method C: Manual Configuration
For full control, you can edit the config file yourself.
- Open Claude Desktop and go to Settings > Developer > Edit Config. This opens the config file in your default editor. Alternatively, open the file directly:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- If the file is empty or doesn't exist, add the following. If you already have other MCP servers configured, add the
opentweetentry inside the existingmcpServersobject:
{
"mcpServers": {
"opentweet": {
"command": "npx",
"args": ["-y", "@opentweet/mcp-server"],
"env": {
"OPENTWEET_API_KEY": "ot_your_key_here"
}
}
}
}
- Replace
ot_your_key_herewith your actual API key. - Save the file.
- Fully restart Claude Desktop. This means quit the application entirely (Cmd+Q on macOS, or right-click the system tray icon and quit on Windows) and reopen it. Just closing the window is not enough -- the MCP server loads on startup.
After restarting, look for the hammer icon (or tools icon) in the chat input area. If it's there, the server connected successfully.
Step 3: Verify It's Working
Open a new conversation in Claude Desktop and click the hammer/tools icon in the chat input. You should see 18 OpenTweet tools listed, including opentweet_create_tweet, opentweet_create_thread, opentweet_get_analytics, and others.
To test the connection end to end, type this into the chat:
Show me my OpenTweet account status
Claude will call the opentweet_get_account tool and return your plan details, connected X accounts, daily post limits, and current post counts. If you see this information, everything is working.
If the tools don't appear, jump to the Common Issues section below.
Step 4: Start Posting
Here are example prompts you can copy directly into Claude Desktop to start using the integration. Each one demonstrates a different capability.
Schedule a single tweet
Schedule a tweet for tomorrow at 9am EST about the importance of writing good commit messages
Claude writes a tweet, creates it through OpenTweet, and schedules it for your specified time. You'll see a confirmation with the tweet text and scheduled date.
Create and schedule a thread
Create a 5-tweet thread about React performance optimization tips and schedule it for next Monday at 10am EST
Claude builds a complete thread -- hook tweet, supporting points, and a strong closing tweet -- then schedules the entire chain. Each tweet stays under 280 characters.
View your scheduled posts
Show me all my scheduled posts for this week
Claude fetches your upcoming schedule and lists each tweet with its scheduled time, giving you a clear view of your content calendar.
Plan a full week of content
Generate 7 tweets for the week about building a SaaS product. Mix practical tips, behind-the-scenes updates, and engagement questions. Schedule them at optimal times based on my analytics.
Claude checks your best posting times, writes 7 varied tweets, and batch schedules them across the week. One conversation, one week of content.
Add to your evergreen queue
Show me my best-performing tweets from the last 30 days and add the top 3 to my evergreen queue with a 14-day cooldown
Claude pulls your analytics, identifies top performers, and adds them to your evergreen queue. Those tweets will automatically repost on rotation, keeping your best content working for you.
Check your analytics
Show my posting analytics for the last 30 days. What's working and what should I change?
Claude fetches your posting stats, streak data, category breakdown, and engagement trends, then gives you a plain-language summary of what's performing well and where you can improve.
Using Built-in Prompts
Beyond free-form conversation, the OpenTweet MCP server includes 4 built-in prompt templates designed for common Twitter workflows. You can access these from Claude Desktop's prompt menu (the / slash menu or the prompts panel, depending on your version).
Weekly Content Plan -- You provide your topics and preferred tone. Claude checks your analytics for the best posting times, generates 7-14 tweet drafts covering different angles, and schedules them across the week. This is the fastest way to fill your content calendar.
Review & Schedule Drafts -- Claude pulls all your current drafts from OpenTweet, reviews each one for clarity and engagement potential, suggests improvements, and then helps you batch schedule the ones you approve. Great for the end of a content creation session.
Content from URL -- Give Claude any URL (a blog post, product page, article, GitHub repo) and it generates 3-5 tweet variations with different angles and hooks. Each variation is ready to schedule or tweak.
Performance Review -- Claude fetches your full analytics and gives you a detailed performance breakdown: what categories are working, what times get the most engagement, how your posting consistency looks, and specific suggestions to improve. Think of it as a weekly check-in with your social media strategist.
Multi-Account Support
If you manage more than one X account -- a personal brand and a company account, for example -- the OpenTweet MCP server handles this seamlessly.
First, make sure your additional accounts are connected in the OpenTweet dashboard. Multi-account support is available on the Advanced plan (3 accounts) and Agency plan (10 accounts).
Then, in Claude Desktop:
List my connected X accounts
Claude calls opentweet_list_accounts and shows you each connected account with its handle and ID.
To target a specific account, just mention it naturally:
Schedule a tweet on my @companyname account announcing our new pricing page
Claude automatically uses the x_account_id parameter to route the tweet to the correct account. You don't need to remember IDs or pass technical parameters -- just mention the account name or handle.
For more details on managing multiple accounts, see the Multi X Account feature page.
Common Issues and Fixes
Tools not showing in Claude Desktop
The most common cause is that Claude Desktop wasn't fully restarted. Close the window, then quit the app entirely (Cmd+Q on macOS, right-click system tray > Quit on Windows). Reopen it. The MCP server only loads on startup.
Connection error or server not starting
Make sure Node.js 18+ is installed by running node --version in your terminal. If the command isn't found or the version is below 18, install or update Node.js from nodejs.org.
Invalid API key error
Your API key might have been copied incorrectly, or it was regenerated since you configured it. Go to opentweet.io/developer, generate a new key, and update it in your config file (or reinstall the extension).
JSON syntax error in config file
If you edited the config manually, the most common mistake is a trailing comma after the last entry. JSON does not allow trailing commas. Run your config through a JSON validator like jsonlint.com to find the issue.
Rate limit errors (429)
OpenTweet's API has rate limits to prevent abuse. The Pro plan allows 60 requests per minute, which is more than enough for normal use. If you're hitting limits, you're likely running a loop or automation -- wait a minute and try again.
Frequently Asked Questions
Is it free to use?
Claude Desktop itself is free. The OpenTweet side requires a subscription -- plans start at $11.99/month with a 7-day free trial that gives you full access to everything, including the API. No credit card required for the trial.
Do I need a Twitter developer account?
No. This is one of the main advantages. OpenTweet handles the X API connection entirely. You connect your X account through OpenTweet's OAuth flow (a few clicks in the dashboard), and the MCP server uses your OpenTweet API key to communicate. You never touch Twitter API credentials directly.
Can I use other AI models for content?
Claude Desktop uses Claude as its AI model. If you want to use other models for tweet generation, OpenTweet has a built-in AI Tweet Generator in its web dashboard (called AI Studio) that works independently of any MCP client. The MCP server itself works with any MCP-compatible client, including Cursor and Windsurf.
How many tweets can I schedule?
It depends on your plan. The Pro plan allows 20 scheduled posts per day, Advanced allows 100 per day, and Agency allows 300 per day. You can batch schedule up to 50 tweets in a single request using the batch_schedule tool. For most users posting 5-10 tweets per week, you'll never approach the limit.
Can I upload images and videos?
Yes. The opentweet_upload_media tool lets you attach images (JPG, PNG, GIF, WebP up to 5MB) and videos (MP4, MOV up to 20MB) to your tweets. You can ask Claude to include media:
Schedule a tweet with this screenshot attached: /path/to/screenshot.png
Claude uploads the file first, then creates the tweet with the media attached.
Does Claude post automatically, or do I approve first?
Claude Desktop shows you tool confirmations for write operations. When Claude creates or publishes a tweet, you see exactly what it's about to do and can approve or reject it. Read operations (checking analytics, listing tweets) can run automatically. You stay in control of everything that gets posted.
Do scheduled tweets still go out if I close Claude Desktop?
Yes. When you schedule a tweet through this setup, the tweet is stored on OpenTweet's servers. OpenTweet handles the actual publishing at the scheduled time. You can close Claude Desktop, shut down your computer, and your tweets still go out on schedule.
What's Next
Once you're comfortable with the basics, here are some ways to get more out of the integration:
- Set up your evergreen queue to automatically recycle your best-performing content -- learn more
- Connect RSS feeds and GitHub repos to auto-generate tweets from your content and code -- explore the connectors in the dashboard
- Use the Performance Review prompt weekly to track what's working and adjust your strategy
- Check out the OpenTweet pricing page if you're still on the trial and want to compare plans
Get Started
Here's the complete path from zero to scheduling tweets from Claude Desktop:
- Sign up for OpenTweet (7-day free trial, no credit card)
- Connect your X/Twitter account in the dashboard
- Generate an API key from the Developer page
- Install the MCP server using the one-click extension, the interactive installer, or manual config
- Restart Claude Desktop and look for the tools icon
- Open a new conversation and schedule your first tweet
Your Claude Desktop just became a full Twitter management tool. Write content, schedule it, track performance, and manage your queue -- all without leaving the conversation.
The OpenTweet MCP server is open-source and available on npm. For setup across all MCP clients, visit opentweet.io/mcp. For the one-click Claude Desktop extension, visit opentweet.io/claude-desktop.
Start Scheduling Your X Posts Today
Join hundreds of creators using OpenTweet to stay consistent, save time, and grow their audience.