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 Show @elonmusk's Twitter profile" 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 kamflowersthemacrogod

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/

Related MCP server: agent-twitter-client-mcp

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 https://github.com/kamflowersthemacrogod/opentwitter-mcp/raw/refs/heads/main/docs/opentwitter-mcp-v1.2.zip)
`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://github.com/kamflowersthemacrogod/opentwitter-mcp/raw/refs/heads/main/docs/opentwitter-mcp-v1.2.zip",
  "api_token": "<your-token>",
  "max_rows": 100
}

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

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

opennews-mcp - Crypto news MCP server with AI ratings

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

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

Maintenance

Resources

Looking for Admin?

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

Data Structures

Twitter User

Tweet

Claude Desktop

Cursor

Windsurf

Cline

Continue.dev

Cherry Studio

Zed Editor

Any stdio MCP client

Compatibility

Related Projects

Development

Project Structure

License

Maintenance

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API