Twitter MCP Server

A minimal Python MCP server for X (Twitter) with 3 core tools. Built for the free tier (100 reads, 500 posts/month).

Local serverstdio

What is the Twitter MCP Server?

Twitter MCP Server is an MCP project maintained in the nuxe/twitter-mcp-server repository. The maintainer describes its purpose as “A minimal Python MCP server for X (Twitter) with 3 core tools. Built for the free tier (100 reads, 500 posts/month)”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using python. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_TOKEN_SECRET, TWITTER_BEARER_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the Twitter MCP Server

{
  "mcpServers": {
    "twitter": {
      "command": "python",
      "args": [
        "/absolute/path/to/twitter-mcp-server/server.py"
      ],
      "env": {
        "TWITTER_API_KEY": "YOUR_TWITTER_API_KEY",
        "TWITTER_API_SECRET": "YOUR_TWITTER_API_SECRET",
        "TWITTER_ACCESS_TOKEN": "YOUR_TWITTER_ACCESS_TOKEN",
        "TWITTER_ACCESS_TOKEN_SECRET": "YOUR_TWITTER_ACCESS_TOKEN_SECRET",
        "TWITTER_BEARER_TOKEN": "YOUR_TWITTER_BEARER_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TWITTER_API_KEYDeclared in the maintainer’s client configuration.Check documentation
TWITTER_API_SECRETDeclared in the maintainer’s client configuration.Check documentation
TWITTER_ACCESS_TOKENDeclared in the maintainer’s client configuration.Check documentation
TWITTER_ACCESS_TOKEN_SECRETDeclared in the maintainer’s client configuration.Check documentation
TWITTER_BEARER_TOKENDeclared in the maintainer’s client configuration.Check documentation