@isteam/twitter-mcp

MCP server for Twitter/X — search tweets, post, reply, and engage via AI agents.

Built by is.team — the AI-native project management platform.

Quick Start

Add to your MCP config (.mcp.json for Claude Code, or Claude Desktop settings):

{
  "mcpServers": {
    "twitter": {
      "command": "npx",
      "args": ["-y", "@isteam/twitter-mcp"],
      "env": {
        "TWITTER_API_KEY": "your-api-key",
        "TWITTER_API_SECRET": "your-api-secret",
        "TWITTER_ACCESS_TOKEN": "your-access-token",
        "TWITTER_ACCESS_TOKEN_SECRET": "your-access-token-secret"
      }
    }
  }
}

Tools (15)

Search & Discovery

Tool	Description
search_tweets	Search tweets by keywords, hashtags, or phrases (max 100 results)
get_mentions	Get recent mentions of the authenticated user
get_user_tweets	Get a user's recent tweets by username

Engagement

Tool	Description
post_tweet	Post a new tweet (max 280 characters)
reply_tweet	Reply to a tweet
quote_tweet	Quote tweet with your commentary
delete_tweet	Delete a tweet
like_tweet	Like a tweet
retweet	Retweet a tweet
follow_user	Follow a user by username

User & Profile

Tool	Description
get_me	Get authenticated user info (followers, following, tweet count)
get_tweet	Get a specific tweet with author info and metrics
get_user	Look up a user by username
update_profile	Update your profile (name, bio, url, location)

Environment Variables

Variable	Required	Description
TWITTER_API_KEY	Yes	Twitter API key (consumer key)
TWITTER_API_SECRET	Yes	Twitter API secret (consumer secret)
TWITTER_ACCESS_TOKEN	Yes	OAuth 1.0a access token
TWITTER_ACCESS_TOKEN_SECRET	Yes	OAuth 1.0a access token secret

Getting your credentials

1. Go to the Twitter Developer Portal
2. Create a project and app
3. Set up OAuth 1.0a with read and write permissions
4. Generate your access token and secret from the "Keys and tokens" tab
5. Copy all four values into your MCP config

Rate Limits & Agent Safety

Twitter API v2 enforces per-endpoint rate limits in 15-minute windows:

Endpoint	Limit	Notes
POST /2/tweets (post, reply, quote)	300 / 15 min	~20/min
GET /2/tweets/search/recent	450 / 15 min	Requires Basic tier
POST /2/users/:id/likes	300 / 15 min
POST /2/users/:id/retweets	300 / 15 min
POST /2/users/:id/following	300 / 15 min
GET /2/users/:id/mentions	450 / 15 min

Idempotency note: Twitter API does not deduplicate identical tweets — posting the same text twice creates two tweets. If your agent retries on timeout, it may create duplicates. Use get_user_tweets to verify before retrying a post.

Backoff: When rate-limited, the API returns 429 Too Many Requests with a x-rate-limit-reset header (Unix timestamp). Wait until that time before retrying.

Usage Examples

Monitor your brand:

"Search for tweets mentioning 'is.team' in the last 24 hours and show engagement metrics"

Engage with your audience:

"Check my recent mentions and reply to any questions with helpful answers"

Post an update:

"Tweet: Just shipped our new AI-powered project management feature! Check it out at is.team"

About is.team

is.team is an AI-native project management platform where AI agents and humans collaborate as real teammates. AI agents join boards, create tasks, chat, and get work done — just like any other team member.

Part of the is.team open-source MCP ecosystem:

• @isteam/mcp — Project management
• @isteam/google-ads-mcp — Google Ads
• @isteam/twitter-mcp — Twitter/X
• @isteam/bluesky-mcp — Bluesky
• @isteam/linkedin-mcp — LinkedIn

License

MIT