X MCP Server

X MCP Server is an MCP server that connects Model Context Protocol clients like Claude Desktop directly to the X (formerly Twitter) platform. Built for developers, social media managers, and researchers who interface with social networks through AI assistants, this integration exposes 26 distinct tools for social interactions and data extraction. Users can read their home timelines, execute keyword searches for recent posts across a seven-day window, and retrieve full body content from X Articles. The server enables publishing new posts, replies, quote tweets, and deletions, alongside media attachments for images and streamed video uploads using X's v2 upload endpoints. Engagement operations include liking, retweeting, and bookmarking content, as well as managing bookmarks. In addition, the server offers tools for user lookups, profile inspections, mentions, lists, and follower retrieval, subject to X API access tiers. The implementation relies on dual authentication, utilizing OAuth 1.0a for standard operations and OAuth 2.0 with token refresh mechanisms for media handling. It also enforces security safeguards such as path restrictions for media uploads and rate limit tracking to maintain reliable communication with the X API.

Category: Communication & Messaging

Tags: microblogging, social-media, twitter, x

Visit X MCP Server

How to install and configure X MCP Server

1. Clone the repository and install dependencies: bash git clone https://github.com/DataWhisker/x-mcp-server.git cd x-mcp-server npm install npm run build 2. Configure your X Developer credentials via OAuth 1.0a and OAuth 2.0. 3. Add the server to %APPDATA%/Claude/claude_desktop_config.json under mcpServers: json { "mcpServers": { "x": { "command": "node", "args": ["C:/path/to/x-mcp-server/build/index.js"], "env": { "TWITTER_API_KEY": "your-api-key", "TWITTER_API_SECRET": "your-api-secret", "TWITTER_ACCESS_TOKEN": "your-access-token", "TWITTER_ACCESS_SECRET": "your-access-secret", "TWITTER_OAUTH2_ACCESS_TOKEN": "your-oauth2-token" } } } } 4. Restart Claude Desktop to enable the tools.

What you can do with X MCP Server

• Publish posts, replies, or quote tweets with attached images or video files directly from conversational prompts in Claude Desktop. - Search recent tweets from the last seven days to monitor brand mentions, track technical topics, or analyze public discussions. - Retrieve and read home timeline feeds, user profiles, mentions, and full-length X Articles to summarize social discourse. - Manage social engagement by liking posts, reposting updates to your timeline, or retrieving and organizing saved bookmarks. - Look up user accounts, retrieve follower or following rosters, and inspect list memberships for audience analysis.

Key facts

• https://github.com/DataWhisker/x-mcp-server
• Communication & Messaging, Other & General Purpose
• microblogging, social-media, twitter, x

Part of MCP Servers

How do I install X MCP Server?

You can install the server by cloning its GitHub repository, running npm install to fetch dependencies, and compiling the TypeScript code using npm run build. Afterward, register the compiled build/index.js entry point into your Claude Desktop configuration file with your Twitter API keys and access tokens specified as environment variables.

What can X MCP Server do?

The server offers 26 tools covering timeline reading, tweet search, post creation, replies, and deletions. It supports attaching images or videos using the v2 media upload API, managing engagements such as likes and retweets, retrieving bookmarked posts, reading X Articles, and fetching user profiles, followers, or lists.

Which MCP clients work with X MCP Server?

X MCP Server is designed to work with Claude Desktop and any standard Model Context Protocol client capable of running local node processes via stdio. You can configure the server definition and required API environment variables inside the client setup file.

What authentication is required for X MCP Server?

Standard operations like posting, searching, and timeline retrieval require OAuth 1.0a credentials, specifically consumer keys and user access tokens from the X Developer Portal. Media uploads require OAuth 2.0 credentials via direct access tokens or client credentials with refresh token auto-renewal enabled.

Is X MCP Server open source?

Yes, X MCP Server is open-source software licensed under the MIT license. Developers can freely inspect, modify, and distribute the source code by visiting the project repository on GitHub, which also welcomes issues and community pull requests.