X Twitter Server enables AI assistants to interact with Twitter (X) through natural language commands using the official Twitter API v2. Key capabilities include: - User profile management: fetch profiles, follower lists, and following lists - Tweet operations: post new tweets, delete tweets, and favorite posts - Search and discovery: search tweets and trending topics on Twitter - Personal organization: manage bookmarks and view personalized timelines - Rate limit protection: built-in handling of Twitter API rate limits - Secure authentication: proper API key and token-based access

X (Twitter) MCP server

[](https://smithery.ai/server/@rafaljanicki/x-twitter-mcp-server) [](https://badge.fury.io/py/x-twitter-mcp)

A Model Context Protocol (MCP) server for interacting with Twitter (X) via AI tools. This server allows you to fetch tweets, post tweets, search Twitter, manage followers, and more, all through natural language commands in AI Tools.

Features

Prerequisites

Installation

Option 1: Installing via Smithery (Recommended)

To install X (Twitter) MCP server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @rafaljanicki/x-twitter-mcp-server --client claude

Option 2: Install from PyPI

pip install x-twitter-mcp

Option 3: Install from Source

1. Clone the Repository:

   git clone https://github.com/rafaljanicki/x-twitter-mcp-server.git
   cd x-twitter-mcp-server
   

2. Set Up a Virtual Environment (optional but recommended):

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install Dependencies: Using uv (recommended, as the project uses uv.lock):

   uv sync
   

   pip install .
   

4. Configure Environment Variables: - Create a .env file in the project root (you can copy .env.example if provided). - Add your Twitter API credentials:

      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
      TWITTER_BEARER_TOKEN=your_bearer_token
      

Running the Server

Preferred transport is Streamable HTTP. Use one of the following:

Recommended: Streamable HTTP (Docker/Smithery)

1. Build the Docker image:

   docker build -t x-twitter-mcp .
   

2. Run the container (Smithery uses PORT; default here is 8081):

   docker run -p 8081:8081 -e PORT=8081 x-twitter-mcp
   

3. Endpoints: - Streamable HTTP (JSON-RPC over HTTP): POST http://localhost:8081/mcp - SSE (Server-Sent Events): GET http://localhost:8081/sse

4. Pass config per-request (recommended in Smithery) via base64-encoded config query parameter. Example config JSON:

   {"twitterApiKey":"...","twitterApiSecret":"...","twitterAccessToken":"...","twitterAccessTokenSecret":"...","twitterBearerToken":"..."}
   

   CONFIG_B64=$(printf '%s' '{"twitterApiKey":"YOUR_KEY","twitterApiSecret":"YOUR_SECRET","twitterAccessToken":"YOUR_TOKEN","twitterAccessTokenSecret":"YOUR_TOKEN_SECRET","twitterBearerToken":"YOUR_BEARER"}' | base64)
   curl -sS -X POST "http://localhost:8081/mcp?config=${CONFIG_B64}" \
     -H 'content-type: application/json' \
     -d '{"jsonrpc":"2.0","id":"1","method":"initialize","params":{"capabilities":{}}}'
   

Notes:

Streamable HTTP (Local, no Docker)

If installed from PyPI:

python -m x_twitter_mcp.http_server

If installed from source with