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...
Getting Started
Prerequisites
- Python 3.8+
- 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!