Twitter MCP Server
@gkydev
A Unofficial Twitter MCP Server with cookie auth.
Overview
What is Twitter MCP Server?
An MCP server that lets AI assistants interact with Twitter using the unofficial twikit library. It uses cookie‑based authentication where the LLM provides ct0 and auth_token cookies directly in each tool call.
How to use Twitter MCP Server?
Clone the repository, install dependencies with pip install -r requirements.txt, then run python server.py. The LLM supplies Twitter cookies (ct0 and auth_token) as parameters in every tool request.
Key features of Twitter MCP Server?
- Cookie‑based authentication with session caching
- Post, like, retweet, and bookmark tweets
- Search tweets and retrieve user timelines
- Get user profiles, statistics, and tweets
- Send, read, react to, and delete direct messages
- Fetch trending topics by category
Use cases of Twitter MCP Server?
- An AI assistant posts scheduled tweets on behalf of a user.
- A chatbot searches for tweets about a topic and summarizes results.
- A customer‑service agent sends direct messages to users from an AI workflow.
- An analytics tool retrieves trending topics to generate daily reports.
- A content moderator collects replies to a tweet for review.
FAQ from Twitter MCP Server
How does authentication work?
The LLM provides two Twitter cookies (ct0 and auth_token) directly in each tool call. No pre‑configuration is required.
What dependencies are needed?
Python is required. Run pip install -r requirements.txt to install all dependencies including twikit.
Is this an official Twitter API?
No. It uses the unofficial twikit library to interact with X/Twitter. The project is intended for educational and experimental purposes only.
How do I get the required cookies?
Open Twitter/X in your browser, log in, and open Developer Tools (F12). Go to Application/Storage → Cookies → twitter.com (or x.com) and copy the ct0 and auth_token values.
What operations are supported?
Operations include posting tweets, liking, retweeting, bookmarking, searching tweets, getting user info, following/unfollowing users, sending and managing direct messages, and retrieving trending topics.
