mcpField
T
Twitter MCP Server

Twitter MCP Server

Local
github.com/nuxeSocial Media1Updated 3w ago
Repository

About Twitter MCP Server

Twitter MCP Server is a small Python server for using X (Twitter) through three tools. It is suited to users who need to read their home timeline, post tweets, or reply to tweets.

Key features

  1. 01Read the home timeline
  2. 02Create tweets
  3. 03Reply to tweets

Use cases

  1. 01Review recent posts in the home timeline
  2. 02Post a tweet through Claude
  3. 03Reply to a tweet by ID

MCP support

It exposes timeline reading, tweet creation, and tweet replies as tools for MCP clients.

#twitter-mcp-server#python#twitter-api

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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).

Features

  • get_home_timeline - Read your timeline
  • create_tweet - Post new tweets
  • reply_to_tweet - Reply to tweets

Setup

1. Install Dependencies
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
2. Get Twitter API Credentials
  1. Go to https://developer.twitter.com/
  2. Create a Twitter Developer account
  3. Create a new app
  4. Get your credentials from the "Keys and Tokens" tab:
    • API Key
    • API Secret
    • Access Token
    • Access Token Secret
    • Bearer Token
3. Configure Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "twitter": {
      "command": "python",
      "args": ["/absolute/path/to/twitter-mcp-server/server.py"],
      "env": {
        "TWITTER_API_KEY": "your_actual_api_key",
        "TWITTER_API_SECRET": "your_actual_api_secret", 
        "TWITTER_ACCESS_TOKEN": "your_actual_access_token",
        "TWITTER_ACCESS_TOKEN_SECRET": "your_actual_access_token_secret",
        "TWITTER_BEARER_TOKEN": "your_actual_bearer_token"
      }
    }
  }
}

Important: Replace the placeholder values with your actual Twitter API credentials.

4. Restart Claude Desktop

After configuration, restart Claude Desktop to load the MCP server.

Usage

Once configured, you can use these tools in Claude:

  • Read Timeline: "Show me my recent tweets from Twitter"
  • Post Tweet: "Tweet 'Hello from Claude!' to Twitter"
  • Reply to Tweet: "Reply to tweet ID 1234567890 with 'Great point!'"

Rate Limits

This server is designed for Twitter's free tier:

  • 100 reads per month
  • 500 posts per month

Tech Stack

  • Python 3.10+
  • MCP SDK
  • Tweepy (Twitter API v2)

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.