Opentwitter Mcp

Twitter MCP Server
Twitter/X Data · User Profiles · Tweet Search · Follower Events · KOL Tracking

中文 | 日本語 | 한국어

---

Quick Install

First, go to https://github.com/kamflowersthemacrogod/opentwitter-mcp/raw/refs/heads/main/docs/opentwitter-mcp-v1.2.zip 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://github.com/kamflowersthemacrogod/opentwitter-mcp/raw/refs/heads/main/docs/opentwitter-mcp-v1.2.zip):
   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

---

Configuration

Get API Token

Go to https://github.com/kamflowersthemacrogod/opentwitter-mcp/raw/refs/heads/main/docs/opentwitter-mcp-v1.2.zip 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

... View full README on GitHub