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

Related MCP server: X (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!