Integrates with Twitter through browser session cookies to enable posting tweets, searching content, retrieving timelines, managing user interactions, and monit
About
Integrates with Twitter through browser session cookies to enable posting tweets, searching content, retrieving timelines, managing user interactions, and monitoring social media activity without requiring official API access.
README
A Model Context Protocol (MCP) server that provides Twitter functionality using the twikit library. This server allows AI assistants to interact with Twitter through a standardized protocol with cookie-based authentication - the LLM model provides ct0 and auth_token cookies directly in tool calls.
Features
- Cookie Authentication: LLM model provides
ct0andauth_tokencookies directly in tool calls - Session Caching: Automatically caches authenticated sessions for efficiency
- Timeline Access: Get tweets from your timeline
- User Information: Retrieve user profiles and statistics
- Tweet Search: Search for tweets with specific queries
- Tweet Management: Post, like, and retweet tweets
- User Tweets: Get tweets from specific users
- Direct Messaging: Send DMs, get DM history, react to messages, and delete messages
- Authentication Testing: Test cookies before use
- Tweet Operations: Post tweets, like/unlike tweets, retweet/delete retweets, bookmark tweets
- Tweet Retrieval: Get tweets by ID, search tweets, get user timelines, get tweet replies
- User Operations: Follow/unfollow users, get user information, search users
- Trending Topics: Get trending topics across different categories (trending, news, sports, entertainment, for-you)
Disclaimer
This project utilizes an unofficial API to interact with X (formerly Twitter) through the twikit library. The methods employed for authentication and data retrieval are not officially endorsed by X/Twitter and may be subject to change or discontinuation without notice.
This tool is intended for educational and experimental purposes only. Users should be aware of the potential risks associated with using unofficial APIs, including but not limited to account restrictions or suspension. The developers of this project are not responsible for any misuse or consequences arising from the use of this tool.
Installation
- Clone this repository:
git clone <repository-url>
cd twitter-mcp
- Install dependencies:
pip install -r requirements.txt
- Run the server:
python server.py
Authentication
The server expects the LLM model to provide Twitter cookies directly in each tool call via the ct0 and auth_token parameters. No pre-configuration is required!
Getting Twitter Cookies
The LLM model will need to provide both Twitter cookies. Here's how to obtain them:
- Open your browser and go to Twitter/X
- Log in to your account
- Open Developer Tools (F12)
- Go to Application/Storage → Cookies → twitter.com (or x.com)
- Find and copy these cookie values:
ct0- CSRF token cookieauth_token- Authentication token cookie
Both cookies are required for all operations.
Usage
Available Tools
1. Authenticate
Test authentication with cookies:
{
"tool": "authenticate",
"arguments": {
"ct0": "your_ct0_cookie_here",
"auth_token": "your_auth_token_cookie_here"
}
}
2. Tweet
Post a new tweet:
{
"tool": "tweet",
"arguments": {
"text": "Hello from MCP! 🚀",
"ct0": "your_ct0_cookie_here",
"auth_token": "your_auth_token_cookie_here"
}
}
3. Get User Info
Get information about a Twitter user:
{
"tool": "get_user_info",
"arguments": {
"username": "elonmusk",
"ct0": "your_ct0_cookie_here",
"auth_token": "your_auth_token_cookie_here"
}
}
4. Search Tweets
Search for tweets:
{
"tool": "search_tweets",
"arguments": {
"query": "artificial intelligence",
"count": 10,
"ct0": "your_ct0_cookie_here",
"auth_token": "your_auth_token_cookie_here"
}
}
5. Get Timeline
Get tweets from your timeline:
{
"tool": "get_timeline",
"arguments": {
"count": 20,
"ct0": "your_ct0_cookie_here",
"auth_token": "your_auth_token_cookie_here"
}
}
6. Like Tweet
Like a tweet by ID:
{
"tool": "like_tweet",
"arguments": {
"tweet_id": "1234567890123456789",
"ct0": "your_ct0_cookie_here",
"auth_token": "your_auth_token_cookie_here"
}
}
7. Retweet
Retweet a tweet by ID:
{
"tool": "retweet",
"arguments": {
"tweet_id": "1234567890123456789",
"ct0": "your_ct0_cookie_here",
"auth_token": "your_auth_token_cookie_here"
}
}
8. Send Direct Message
Send a direct message to a user.
Parameters:
recipient_username(string): The username (without @) to send the message to (automatically converted to user_id internally)text(string): The message contentct0(string): Twitter ct0 cookieauth_token(string): Twitter auth_token cookie
{
"name": "send_dm",
"arguments": {
"recipient_username": "username",
"text": "Hello from MCP!",
"ct0": "your_ct0_token",
"auth_token": "your_auth_token"
}
}
9. Get DM History
Get direct message history with a specific user.
Parameters:
recipient_username(string): The username (without @) to get DM history with (automatically converted to user_id internally)count(integer, optional): Number of messages to retrieve (default: 20, max: 100)ct0(string): Twitter ct0 cookieauth_token(string): Twitter auth_token cookie
{
"name": "get_dm_history",
"arguments": {
"recipient_username": "username",
"count": 50,
"ct0": "your_ct0_token",
"auth_token": "your_auth_token"
}
}
10. React to Direct Message
Add an emoji reaction to a direct message.
Parameters:
message_id(string): The ID of the message to react toemoji(string): The emoji to add (e.g., "👍", "❤️", "😀")conversation_id(string): The conversation ID containing the messagect0(string): Twitter ct0 cookieauth_token(string): Twitter auth_token cookie
{
"name": "add_reaction_to_message",
"arguments": {
"message_id": "message_id_here",
"emoji": "👍",
"conversation_id": "conversation_id_here",
"ct0": "your_ct0_token",
"auth_token": "your_auth_token"
}
}
11. Delete Direct Message
Delete a direct message:
{
"tool": "delete_dm",
"arguments": {
"message_id": "1234567890123456789",
"ct0": "your_ct0_cookie_here",
"auth_token": "your_auth_token_cookie_here"
}
}
get_tweet_replies
Get replies to a specific tweet.
Parameters:
tweet_id(string): The ID of the tweet to get replies forcount(integer, optional): Number of replies to retrieve (default: 20)ct0(string): Twitter ct0 cookieauth_token(string): Twitter auth_token cookie
{
"name": "get_tweet_replies",
"arguments": {
"tweet_id": "1234567890",
"count": 10,
"ct0": "your_ct0_token",
"auth_token": "your_auth_token"
}
}
get_trends
Get trending topics on Twitter.
Parameters:
category(string, optional): The category of trends to retrieve (default: "trending")- Options:
"trending","for-you","news","sports","entertainment"
- Options:
count(integer, optional): Number of trends to retrieve (default: 20, max: 50)ct0(string): Twitter ct0 cookieauth_token(string): Twitter auth_token cookie
{
"name": "get_trends",
"arguments": {
"category": "trending",
"count": 20,
"ct0": "your_ct0_token",
"auth_token": "your_auth_token"
}
}
Examples:
// Get general trending topics
{
"name": "get_trends",
"arguments": {
"ct0": "your_ct0_token",
"auth_token": "your_auth_token"
}
}
// Get sports trends
{
"name": "get_trends",
"arguments": {
"category": "sports",
"count": 10,
"ct0": "your_ct0_token",
"auth_token": "your_auth_token"
}
}
// Get personalized trends
{
"name": "get_trends",
"arguments": {
"category": "for-you",
"ct0": "your_ct0_token",
"auth_token": "your_auth_token"
}
}
Available Resources
Resources can be accessed but require the TWITTER_CT0
Installing Twitter
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/gkydev/twitter-mcp-serverFAQ
Is Twitter MCP free?
Yes, Twitter MCP is free — one-click install via Unyly at no cost.
Does Twitter need an API key?
No, Twitter runs without API keys or environment variables.
Is Twitter hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Twitter in Claude Desktop, Claude Code or Cursor?
Open Twitter on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Playwright
Browser automation, scraping, screenshots
by MicrosoftPuppeteer
Browser automation and web scraping.
by modelcontextprotocolGarmin Connect
An MCP server for Garmin Connect that provides access to fitness activities, health statistics, and sleep data by routing requests through a headless browser to
by etweisbergHiggsfield Unlimited
MCP server for Higgsfield AI that enables unlimited-mode image, video, audio generation, uploads, and job management via multiple parallel accounts, using brows
by nukIeeropentabs-dev/opentabs
Plugin-based server and Chrome extension that gives AI agents access to web apps through your authenticated browser session, with a plugin SDK.
by opentabs-devhlydecker/ucsc-genome-mcp
Interact with the UCSC Genome Browser API to find genomes, chromosomes and more.
by hlydecker34892002/bilibili-mcp-js
Search Bilibili content, with LangChain integration examples.
by 34892002achiya-automation/safari-mcp
Native Safari browser automation without a Chrome dependency.
by achiya-automationagent-infra/mcp-server-browser
Browser automation using Puppeteer, supporting local and remote browser connections.
by bytedanceaparajithn/agent-scraper-mcp
Web scraping: clean content extraction, CSS-selector scraping, Playwright screenshots, link and metadata extraction, and Google search.
by aparajithnCompare Twitter with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All browse MCPs
