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.
Give any AI agent (Claude Code, Cursor, Windsurf, etc.) the ability to read, write, and engage on Twitter/X.
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"
}
}
}
}
pip install shippost-mcp
| 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 |
| 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
| 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 |
MIT
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)
com.mcparmory/google-search
io.github.pipeworx-io/brave-search
marcopesani/mcp-server-serper
brave/brave-search-mcp-server
com.mcparmory/google-search-console
acamolese/google-search-console-mcp