X Twitter MCP Server

The X (Twitter) MCP server is a protocol server for interacting with Twitter through AI tools, supporting functions such as getting tweets, posting tweets, searching on Twitter, and managing followers. It uses Twitter API v2 for secure authentication.

Social media Developer tools #Twitter interaction #AI tools #Tweet management #API service .Python

rating : 2.5 points

downloads : 16

update time : 2025-04-29

What is the X (Twitter) MCP server?

This is a Twitter interaction server specifically designed for AI tools, allowing you to perform various Twitter operations through natural language commands without writing code or directly calling the API.

How to use the Twitter MCP server?

After installing the server, you can operate Twitter through natural language commands in AI tools such as Claude, for example, 'Get my latest tweets' or 'Post a tweet'.

Use cases

Suitable for users who need to automate the management of Twitter accounts, analyze tweet data, or perform social operations in batches through AI.

Main features

User managementGet user profiles, follower lists, and following lists

Tweet managementPost, delete, like, and favorite tweets

Search functionSearch for tweets and trending topics

Timeline managementGet the home timeline and mention messages

Advantages and limitations

Advantages

Operate Twitter through natural language without programming knowledge

Use the official API v2 to avoid the risk of account suspension

Built - in API call frequency limit handling

Support a complete set of Twitter functions

Limitations

A Twitter developer account and API keys are required

Some advanced functions may be restricted by the API

Python environment support is required

How to use

Install the server

Install through PyPI or build from source code

Configure API keys

Set the API credentials of your Twitter developer account in the.env file

Connect AI tools

Configure the MCP server settings of Claude Desktop

Usage examples

Get user profileQuery the public information of a specific Twitter user

Post a tweetPost a tweet directly through an AI tool

Frequently Asked Questions

Do I need a Twitter developer account?

Does it support multi - account management?

Related resources

Twitter Developer Portal

The official website for applying for API keys

GitHub Repository

Project source code and issue tracking

🚀 X Twitter Management Control Panel (MCP) Server Documentation

X Twitter MCP Server is a tool designed to manage and control the Twitter platform. It offers a wide range of features to help users automate and optimize their Twitter experience. This guide will provide detailed instructions on how to install, configure, and use the server, along with troubleshooting and other useful information.

🚀 Quick Start

This section provides a high - level overview of the installation and startup process. For detailed steps, refer to the Installation Guide.

✨ Features

X Twitter MCP Server offers multiple functional modules, including user management, Tweet operations, search, and trends.

User Management

get_timeline: Retrieve the user's home timeline.
get_latest_timeline: Get the timeline of the users the account follows.
search_twitter: Search Twitter based on a query term.
get_trends: Fetch the current trending topics on Twitter.

Tweet Operations

favorite_tweet: Like a tweet.
unfavorite_tweet: Unlike a tweet.
bookmark_tweet: Add a tweet to bookmarks.
delete_bookmark: Remove a tweet from bookmarks.
delete_all_bookmarks: Delete all bookmarks.

Search and Trends

search_twitter: Search Twitter using a query term, with a limit on the number of results (default is 10).
get_trends: Get up to the top 10 currently popular topics.

📦 Installation

Installation Methods

Method 1: Install from Source Code

Clone the GitHub repository.
Open a terminal and navigate to the cloned folder.
Run the following command to install dependencies:

pip install -r requirements.txt

Edit the .env file and fill in your Twitter API credentials.

Method 2: Install using PyPI

Run the following command in the terminal:

pip install x-twitter-mcp-server

Configure environment variables by referring to claude_desktop_config.json.

Start the Server

Open a terminal and navigate to the installation directory.
Run the startup script:

python -m x_twitter_mcp_server

💻 Usage Examples

Basic Usage

Here are some basic API calls to demonstrate the server's functionality:

# Import the necessary module
from x_twitter_mcp_server import XTwitterMCP

# Initialize the client
client = XTwitterMCP()

# Get the user's timeline
timeline = client.get_timeline()
print(timeline)

# Search for tweets
search_results = client.search_twitter(query="python")
print(search_results)

Advanced Usage

# Import the necessary module
from x_twitter_mcp_server import XTwitterMCP

# Initialize the client
client = XTwitterMCP()

# Favorite a tweet
tweet_id = "1234567890"
client.favorite_tweet(tweet_id)

# Get the latest trends
trends = client.get_trends()
print(trends)

📚 Documentation

Troubleshooting

Server Fails to Start

Ensure that the .env file contains all the necessary Twitter API credentials (for installations from source code).
For users who installed via PyPI, confirm that environment variables are set in claude_desktop_config.json or in the shell.
Check the startup logs in the terminal for error messages.
Make sure that uv or the Python executable is correctly installed and accessible.

Claude Does Not Detect the Server

Verify that the paths in claude_desktop_config.json are correct.
Confirm that commands and parameters point to the correct executable files and scripts.
Restart Claude Desktop after updating the configuration file.
Enable developer mode and check the log files for more error information.

Rate Limit Errors

The server has a built - in rate limit handling mechanism. If you encounter Twitter API rate limits, please wait for the reset window (e.g., 15 minutes for tweet operations).