How do I use Twitter MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Twitter MCP Server find popular tweets about #AI with more than 1000 likes" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Twitter MCP Server by 6551Team

Quick Install

First, go to https://6551.io/mcp to get your API Token.

Claude Code

claude mcp add twitter \
  -e TWITTER_TOKEN=<your-token> \
  -- uv --directory /path/to/twitter-mcp run twitter-mcp

Replace /path/to/twitter-mcp with your local project path, and <your-token> with your Token.

OpenClaw

export TWITTER_TOKEN="<your-token>"
cp -r openclaw-skill/opentwitter ~/.openclaw/skills/

Let AI Review & Install For You

Not sure if this MCP is safe? Paste the prompt below to your AI assistant — it will review the source code first, then install if safe:

Copy this prompt and send it to your AI assistant (replace <project-path> and <your-token> with actual values):

Please review and install the twitter-mcp MCP server for me. The project is at <project-path>.

Steps:
1. Review these files for security:
   - src/twitter_mcp/api_client.py — Confirm it only connects to ai.6551.io, no data sent elsewhere
   - src/twitter_mcp/config.py — Confirm token is only read from local config.json or env vars, no hardcoded secrets or leaks
   - src/twitter_mcp/tools.py — Confirm all tools only perform API queries, no file writes, command execution, or dangerous operations
   - pyproject.toml — Confirm dependencies are only mcp, httpx, no suspicious packages
2. Tell me your conclusion: safe / risky / problematic, with specific reasons
3. If safe, run the install (get Token from https://6551.io/mcp):
   claude mcp add twitter -e TWITTER_TOKEN=<your-token> -- uv --directory <project-path> run twitter-mcp

What Can It Do?

Once connected, just ask your AI assistant:

You say	It does
"Show @elonmusk's Twitter profile"	Get user profile info
"What did @VitalikButerin tweet recently"	Get user's recent tweets
"Search Bitcoin related tweets"	Keyword search
"Find tweets with #crypto hashtag"	Hashtag search
"Popular tweets about ETH with 1000+ likes"	Search with engagement filters
"Who followed @elonmusk recently"	Get new follower events
"Who unfollowed @elonmusk"	Get unfollower events
"What tweets did @elonmusk delete"	Get deleted tweets
"Which KOLs follow @elonmusk"	Get KOL followers

Available Tools

Tool	Description
`get_twitter_user`	Get user profile by username
`get_twitter_user_by_id`	Get user profile by numeric ID
`get_twitter_user_tweets`	Get recent tweets from a user
`search_twitter`	Search tweets with basic filters
`search_twitter_advanced`	Advanced search with multiple filters
`get_twitter_follower_events`	Get follower/unfollower events
`get_twitter_deleted_tweets`	Get deleted tweets from a user
`get_twitter_kol_followers`	Get KOL (Key Opinion Leader) followers
`get_twitter_article_by_id`	Get Twitter article by ID
`get_twitter_watch`	Get all Twitter monitoring users
`add_twitter_watch`	Add a Twitter user to monitoring list
`delete_twitter_watch`	Delete a Twitter user from monitoring list

Configuration

Get API Token

Go to https://6551.io/mcp to get your API Token.

Set the environment variable:

# macOS / Linux
export TWITTER_TOKEN="<your-token>"

# Windows PowerShell
$env:TWITTER_TOKEN = "<your-token>"

Variable	Required	Description
`TWITTER_TOKEN`	Yes	6551 API Bearer Token (get from https://6551.io/mcp)
`TWITTER_API_BASE`	No	Override REST API URL
`TWITTER_MAX_ROWS`	No	Max results per query (default: 100)

Also supports config.json in the project root (env vars take precedence):

{
  "api_base_url": "https://ai.6551.io",
  "api_token": "<your-token>",
  "max_rows": 100
}

WebSocket Real-time Subscriptions

Endpoint: wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN

Subscribe to real-time events from your monitored Twitter accounts.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "twitter.subscribe"
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true
  }
}

Unsubscribe

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "twitter.unsubscribe"
}

Server Push - Twitter Event

When a monitored account has activity, the server pushes:

{
  "jsonrpc": "2.0",
  "method": "twitter.event",
  "params": {
    "id": 123456,
    "twAccount": "elonmusk",
    "twUserName": "Elon Musk",
    "profileUrl": "https://twitter.com/elonmusk",
    "eventType": "NEW_TWEET",
    "content": "...",
    "ca": "0x1234...",
    "remark": "Custom note",
    "createdAt": "2026-03-06T10:00:00Z"
  }
}

Note: The content field structure varies by event type (see below).


**Event Types and Content Structure**:

#### Tweet Events
- `NEW_TWEET` - New tweet posted
- `NEW_TWEET_REPLY` - New reply tweet
- `NEW_TWEET_QUOTE` - New quote tweet
- `NEW_RETWEET` - Retweeted
- `CA` - Tweet with CA address

Content structure for tweet events:
```json
{
  "id": "1234567890",
  "text": "Tweet content...",
  "createdAt": "2026-03-06T10:00:00Z",
  "language": "en",
  "retweetCount": 100,
  "favoriteCount": 500,
  "replyCount": 20,
  "quoteCount": 10,
  "viewCount": 10000,
  "userScreenName": "elonmusk",
  "userName": "Elon Musk",
  "userIdStr": "44196397",
  "userFollowers": 170000000,
  "userVerified": true,
  "conversationId": "1234567890",
  "isReply": false,
  "isQuote": false,
  "hashtags": ["crypto", "bitcoin"],
  "media": [
    {
      "type": "photo",
      "url": "https://...",
      "thumbUrl": "https://..."
    }
  ],
  "urls": [
    {
      "url": "https://...",
      "expandedUrl": "https://...",
      "displayUrl": "example.com"
    }
  ],
  "mentions": [
    {
      "username": "VitalikButerin",
      "name": "Vitalik Buterin"
    }
  ]
}

Follower Events

NEW_FOLLOWER - New follower
NEW_UNFOLLOWER - Unfollower event

Content structure for follower events (array):

[
  {
    "id": 123,
    "twId": 44196397,
    "twAccount": "elonmusk",
    "twUserName": "Elon Musk",
    "twUserLabel": "Verified",
    "description": "User bio...",
    "profileUrl": "https://...",
    "bannerUrl": "https://...",
    "followerCount": 170000000,
    "friendCount": 500,
    "createdAt": "2026-03-06T10:00:00Z"
  }
]

Profile Update Events

UPDATE_NAME - Username changed (content: new name string)
UPDATE_DESCRIPTION - Bio updated (content: new description string)
UPDATE_AVATAR - Profile picture changed (content: new avatar URL string)
UPDATE_BANNER - Banner image changed (content: new banner URL string)

Other Events

TWEET_TOPPING - Tweet pinned
DELETE - Tweet deleted
SYSTEM - System event
TRANSLATE - Tweet translation
CA_CREATE - CA token created

Data Structures

Twitter User

{
  "userId": "44196397",
  "screenName": "elonmusk",
  "name": "Elon Musk",
  "description": "...",
  "followersCount": 170000000,
  "friendsCount": 500,
  "statusesCount": 30000,
  "verified": true
}

{
  "id": "1234567890",
  "text": "Tweet content...",
  "createdAt": "2024-02-20T12:00:00Z",
  "retweetCount": 1000,
  "favoriteCount": 5000,
  "replyCount": 200,
  "userScreenName": "elonmusk",
  "hashtags": ["crypto", "bitcoin"],
  "urls": [{"url": "https://..."}]
}

In all configs below, replace /path/to/twitter-mcp with your actual local project path, and <your-token> with your Token from https://6551.io/mcp.

Claude Desktop

Edit config (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "TWITTER_TOKEN": "<your-token>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json or Settings > MCP Servers:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "TWITTER_TOKEN": "<your-token>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "TWITTER_TOKEN": "<your-token>"
      }
    }
  }
}

Cline

VS Code sidebar > Cline > MCP Servers > Configure, edit cline_mcp_settings.json:

{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
      "env": {
        "TWITTER_TOKEN": "<your-token>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue.dev

~/.continue/config.yaml:

mcpServers:
  - name: twitter
    command: uv
    args:
      - --directory
      - /path/to/twitter-mcp
      - run
      - twitter-mcp
    env:
      TWITTER_TOKEN: <your-token>

Cherry Studio

Settings > MCP Servers > Add > Type stdio: Command uv, Args --directory /path/to/twitter-mcp run twitter-mcp, Env TWITTER_TOKEN.

Zed Editor

~/.config/zed/settings.json:

{
  "context_servers": {
    "twitter": {
      "command": {
        "path": "uv",
        "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
        "env": {
          "TWITTER_TOKEN": "<your-token>"
        }
      }
    }
  }
}

Any stdio MCP client

TWITTER_TOKEN=<your-token> \
  uv --directory /path/to/twitter-mcp run twitter-mcp

Compatibility

Client	Install Method	Status
Claude Code	`claude mcp add`	One-liner
OpenClaw	Copy skill directory	One-liner
Claude Desktop	JSON config	Supported
Cursor	JSON config	Supported
Windsurf	JSON config	Supported
Cline	JSON config	Supported
Continue.dev	YAML / JSON	Supported
Cherry Studio	GUI	Supported
Zed	JSON config	Supported

Development

cd /path/to/twitter-mcp
uv sync
uv run twitter-mcp

# MCP Inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/twitter-mcp run twitter-mcp

Project Structure

├── README.md
├── docs/
│   ├── README_JA.md           # 日本語
│   └── README_KO.md           # 한국어
├── openclaw-skill/opentwitter/    # OpenClaw Skill
├── pyproject.toml
├── config.json
└── src/twitter_mcp/
    ├── server.py              # Entry point
    ├── app.py                 # FastMCP instance
    ├── config.py              # Config loader
    ├── api_client.py          # HTTP client
    └── tools.py               # 8 tools

License

MIT

Twitter MCP Server

Quick Install

Claude Code

OpenClaw

Let AI Review & Install For You

What Can It Do?

Available Tools

Configuration

Get API Token

WebSocket Real-time Subscriptions

Unsubscribe

Server Push - Twitter Event

Follower Events

Profile Update Events

Other Events

Data Structures

Twitter User

Tweet

Claude Desktop

Cursor

Windsurf

Cline

Continue.dev

Cherry Studio

Zed Editor

Any stdio MCP client

Compatibility

Development

Project Structure

License

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

Quick Install

Claude Code

OpenClaw

Let AI Review & Install For You

What Can It Do?

Available Tools

Configuration

Get API Token

WebSocket Real-time Subscriptions

Subscribe to Twitter Events

Unsubscribe

Server Push - Twitter Event

Follower Events

Profile Update Events

Other Events

Data Structures

Twitter User

Tweet

Claude Desktop

Cursor

Windsurf

Cline

Continue.dev

Cherry Studio

Zed Editor

Any stdio MCP client

Compatibility

Development

Project Structure

License

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API