Back to Catalog

mcp-twitter

LuniaKunal/mcp-twitter
🔗 Latest commit:9685b02
🕒 Updated:Sep 9, 2025, 01:06 PM
Python
Social Media

Manage your twitter account using mcp

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score48/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:25
👥 Contributors:1
📋 Total Issues:0
📦 Has Releases:No
🔧 Has CI/CD Pipeline:No
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "twitter-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "Path\\src\\",
      "run",
      "--with",
      "twikit",
      "--with",
      "mcp",
      "tweet_service.py"
    ],
    "env": {
      "COOKIES_PATH": "Path\\cookies.json",
      "ENV_FILE": ".env"
    }
  }
}
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:
Prompts:
Resources:
Sampling:
Roots:
Logging:
STDIO Transport:
HTTP Transport:
OAuth2 Auth:
Dependencies
3 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/LuniaKunal/mcp-twitter)](https://archestra.ai/mcp-catalog/luniakunal__mcp-twitter)
README.md

Twitter MCP Server

Welcome to the Twitter MCP (Multi-Channel Platform) Server! This application helps you manage your Twitter account programmatically with a variety of powerful features.

Features

  • Get Timeline: Retrieve your Twitter home timeline.
  • Get Any User's Tweets: Fetch tweets from any public Twitter user.
  • Hashtag Search: Search for tweets containing any hashtag (e.g., #AI).
  • Get Replies & Summaries: Retrieve replies to tweets and get summarized insights.
  • User Direct Messages: Send and receive Twitter DMs.
  • Create Post: Programmatically create new tweets.
  • Delete Post: Delete your tweets through the API.
  • And much more...

Twitter MCP Server

Twitter MCP Server

Getting Started

Prerequisites

  • Python 3.11+
  • uvicorn (for running the server)
  • Twitter API credentials (set in .env file)

Installation

  1. Clone this repository.
  2. Install dependencies:
    pip install -r requirements.txt
    
  3. Set up your .env file with your Twitter API credentials (see .env.example).

Running the Application

To start the server, run:

uv run --with twikit --with mcp Path\\src\\tweet_service.py
{
  "mcpServers": {
  "twitter-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "Path\\src\\",
      "run",
      "--with",
      "twikit",
      "--with",
      "mcp",
      "tweet_service.py"
    ],
    "env": {
      "COOKIES_PATH": "Path\\cookies.json",
      "ENV_FILE": ".env"  
    }
  }

}
}

Feel free to contribute or suggest new features!

mcp-twitter MCP Server | Documentation & Integration | Archestra