Summary
Gives Claude direct access to Twitter/X through OAuth 2.0, exposing the standard operations you'd expect: reading timelines and mentions, posting tweets and replies, searching, liking, retweeting, and following. The free tier covers all basic Twitter API interactions. There's also a paid ShipPost AI layer that adds higher-level capabilities like scanning your timeline for engagement opportunities, drafting replies in your voice, and analyzing accounts. Useful when you want Claude to monitor Twitter conversations, engage with relevant tweets, or handle routine social media tasks without leaving your editor. Supports Claude Code, Cursor, and similar MCP-compatible environments.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →ShipPost MCP — Twitter/X tools for AI agents
Give any AI agent (Claude Code, Cursor, Windsurf, etc.) the ability to read, write, and engage on Twitter/X.
Quick Start
Claude Code
Add to your ~/.claude/settings.json:
{
"mcpServers": {
"twitter": {
"command": "shippost-mcp",
"env": {
"TWITTER_ACCESS_TOKEN": "your-access-token",
"TWITTER_REFRESH_TOKEN": "your-refresh-token",
"TWITTER_CLIENT_ID": "your-client-id"
}
}
}
}
Install from PyPI
pip install shippost-mcp
Free Tools
| Tool | Description |
|---|---|
get_my_profile | Get your Twitter profile |
get_timeline | Read your home timeline |
get_mentions | Get tweets mentioning you |
get_user_profile | Look up any user's profile |
get_tweet | Get a specific tweet by ID |
search_tweets | Search recent tweets |
post_tweet | Post a tweet |
reply_to_tweet | Reply to a tweet |
like_tweet | Like a tweet |
retweet | Retweet a tweet |
follow_user | Follow a user |
Paid AI Tools (requires ShipPost API key)
| Tool | Description |
|---|---|
find_opportunities | AI scans your timeline for the best tweets to reply to |
draft_reply | AI drafts a reply in your voice |
draft_tweet | AI drafts an original tweet |
draft_thread | AI drafts a full thread |
analyze_account | AI analyzes any Twitter account |
get_performance | AI-powered engagement analytics |
Get your API key at shippost.ai
Configuration
| Env Var | Required | Description |
|---|---|---|
TWITTER_ACCESS_TOKEN | Yes | OAuth 2.0 access token |
TWITTER_REFRESH_TOKEN | Recommended | For automatic token renewal |
TWITTER_CLIENT_ID | For refresh | Your Twitter app's client ID |
SHIPPOST_API_KEY | For AI features | Get at shippost.ai |
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
TWITTER_ACCESS_TOKEN*secretYour Twitter OAuth 2.0 access token
TWITTER_REFRESH_TOKENsecretTwitter refresh token for automatic renewal
TWITTER_CLIENT_IDYour Twitter app client ID (needed for token refresh)
SHIPPOST_API_KEYsecretShipPost API key for AI-powered features (get at https://shippost.ai)
Registryactive
Packageshippost-mcp
TransportSTDIO
AuthRequired
UpdatedMar 29, 2026
