X (Twitter) MCP Server

What is X (Twitter) MCP Server?

This MCP server allows AI clients to interact with X (formerly Twitter), enabling comprehensive platform operations including posting tweets, searching content, managing accounts, and organizing lists. It is designed for developers using MCP-compatible clients such as Claude.

How to use X (Twitter) MCP Server?

Set up an X Developer account, obtain your API keys, and set the required environment variables (TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_TOKEN_SECRET). Clone the repository, run npm install, and start the server with the environment variables or a .env file. Then configure your MCP client (e.g., Claude) with a JSON pointing to dist/index.js and the environment variables. Requires Node.js 18+.

Key features of X (Twitter) MCP Server

• Post tweets up to 280 characters
• Search for tweets by query with adjustable result count
• Get and update authenticated user profile information
• Follow and unfollow users
• List followers and accounts a user is following
• Create, retrieve, and list lists (public or private)

Use cases of X (Twitter) MCP Server

• Posting tweets directly from an AI assistant
• Searching for recent content on X programmatically
• Managing followers and following lists automatically
• Updating profile details like name, bio, or location
• Organizing users into lists for monitoring or curation

FAQ from X (Twitter) MCP Server

What MCP tools does the server provide?

The server exposes eleven tools: post_tweet, search_tweets, get_profile, update_profile, follow_user, unfollow_user, list_followers, list_following, create_list, get_list_info, and get_user_lists.

What are the system requirements and dependencies?

Node.js 18.x or higher and a valid X Developer account with API v1 and v2 access. You need to set four environment variables: TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, and TWITTER_ACCESS_TOKEN_SECRET.

How do I configure the server with Claude?

Add a JSON entry to your Claude MCP configuration file (located in %APPDATA%\AnthropicClaude\mcp-servers on Windows, ~/Library/Application Support/AnthropicClaude/mcp-servers on macOS, or ~/.config/AnthropicClaude/mcp-servers on Linux) specifying the server name, path to dist/index.js, and the environment variables.

Is there a character limit for posts?

Yes, posts are limited to 280 characters when using the post_tweet tool.