← Back to directory
O

OpenTwitter MCP Server

Community
Twitter/X Data · User Profiles · Tweet Search · Follower Events · KOL Tracking
GitHub source repository ↗
★ 1.4k Stars Category · Other Very popular Source revision 5484baaadf74
49FMRS · D
Reliability
5/20
Security and permissions
7/20
Maintenance
10/20
Documentation
14/20
Setup experience
13/20

The server is designed to connect exclusively to the ai.6551.io API. Code review indicates that tools only perform API queries, with no file writes, command execution, or other dangerous operations. Configuration only reads tokens from environment variables or config.json, with no hardcoded secrets. Dependencies are limited to mcp and httpx; no suspicious packages were found.

Read the FMRS scoring method →

opentwitter-mcp is an MCP server that provides access to Twitter/X data via an API. It enables AI assistants to fetch user profiles, search tweets, monitor follower events, track KOL followers, and manage real-time watch lists. The server authenticates using an OPENNEWS_TOKEN via environment variables or config file, and supports real-time event subscriptions via WebSocket.

Tools

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_tweet_by_id
Get tweet by ID with nested reply/quote tweets
get_twitter_quote_tweets_by_id
Get tweets that quote a specific tweet
get_twitter_retweet_users_by_id
Get users who retweeted a specific tweet
get_twitter_watch
Get all Twitter monitoring users
add_twitter_watch
Add a Twitter user to monitoring list (with event type options)
delete_twitter_watch
Delete a Twitter user from monitoring list

Setup

  1. Obtain an API token from http://app.newsliquid.com/mcp. 2. Set the OPENNEWS_TOKEN environment variable. 3. Use the uv command: uv --directory /path/to/twitter-mcp run twitter-mcp. 4. For Claude Code: claude mcp add twitter -e OPENNEWS_TOKEN=<your-token> -- uv --directory /path/to/twitter-mcp run twitter-mcp. 5. Alternatively, configure the server in your client's JSON configuration.
claude_desktop_config.json
{
  "mcpServers": {
    "twitter": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/twitter-mcp",
        "run",
        "twitter-mcp"
      ],
      "env": {
        "OPENNEWS_TOKEN": "<your-token>"
      }
    }
  }
}

Fit and risk

Best for

  • Developers
  • Data analysts
  • Marketers needing real-time Twitter account monitoring
  • AI assistant users integrating Twitter data into workflows

Not for

  • Users who do not need Twitter data
  • Users requiring data from X's official API rather than a third-party API
  • Users concerned about sending data to a third-party service

Required permissions

  • Network access to connect to api.6551.io and wss://ai.6551.io
  • API token from environment variable or config.json
  • No file system writes or other local system permissions

Risks and side effects

  • Dependence on third-party API service for data
  • Token leakage could lead to unauthorized usage
  • API service may become unavailable or change
  • Data may be incomplete or delayed as it is not from an official source

Troubleshooting

  1. Ensure the OPENNEWS_TOKEN environment variable is set correctly
  2. Check network connectivity
  3. Verify that the API service is accessible
  4. Confirm the project path is correct
  5. Ensure uv is installed and available

Use cases

Show @elonmusk's Twitter profile
Get recent tweets from @VitalikButerin
Search for Bitcoin-related tweets
Find tweets with #crypto hashtag
Get popular tweets about ETH with 1000+ likes
Monitor @elonmusk with follower tracking

Supported clients

Claude DesktopFull support
Claude CodeFull support
CursorFull support
WindsurfFull support
ClineFull support
Continue.devFull support
Cherry StudioFull support
ZedFull support
OpenClawFull support