Twitter MCP Server

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 ct0 and auth_token cookies 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 cookie
- auth_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 content
ct0 (string): Twitter ct0 cookie
auth_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 cookie
auth_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 to
emoji (string): The emoji to add (e.g., "👍", "❤️", "😀")
conversation_id (string): The conversation ID containing the message
ct0 (string): Twitter ct0 cookie
auth_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 for
count (integer, optional): Number of replies to retrieve (default: 20)
ct0 (string): Twitter ct0 cookie
auth_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"
count (integer, optional): Number of trends to retrieve (default: 20, max: 50)
ct0 (string): Twitter ct0 cookie
auth_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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables AI assistants to interact with Twitter functionality using cookie-based authentication, allowing for timeline access, tweet management, user information retrieval, and search capabilities.

Related MCP Servers

Twitter MCP Server
taazkareem
-
security
F
license
-
quality
Provides AI agents with comprehensive Twitter functionality through the Model Context Protocol standard, enabling reading tweets, posting content, managing interactions, and accessing timeline data with robust error handling.
Last updated -
4
1
JavaScript
MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
MCP-Twikit
Zo-Valentine
-
security
A
license
-
quality
A Model Context Protocol server that enables AI to interact with Twitter, allowing functions like searching tweets, comparing sentiments across accounts, and retrieving timeline content.
Last updated -
MIT License
MCP Twitter
0xhijo
-
security
A
license
-
quality
A Model Context Protocol server that enables AI models and applications to interact directly with Twitter/X, providing capabilities to create posts, reply to tweets, retrieve user data, and manage account actions.
Last updated -
87
4
TypeScript
MIT License

View all related MCP servers

Twitter MCP Server