@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"
      }
    }
  }
}

Related MCP server: x-mcp

Tools (15)

Search & Discovery

Engagement

User & Profile

Environment Variables

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:

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