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

• Core MCP protocol features implemented (20/40)
• Room for improvement in GitHub community
• Optimal dependency management (20/20)
• Room for improvement in deployment maturity
• Documentation (8/8)
• Archestra MCP Trust score badge is missing

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

Main

mcp

twikit

Light

python-dotenv

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

Getting Started

Prerequisites

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

Installation

Clone this repository.
Install dependencies:
```
pip install -r requirements.txt
```
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!

Resources

GitHub Repository

Add Quality Badge

Show your MCP trust score in your README

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/LuniaKunal/mcp-twitter)](https://archestra.ai/mcp-catalog/luniakunal__mcp-twitter)

Edit This Server Add New MCP Server Report an Issue

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

Getting Started

Prerequisites

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

Installation

Clone this repository.
Install dependencies:
```
pip install -r requirements.txt
```
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!