How do I install the x mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `API_KEY`, `API_SECRET_KEY`, `ACCESS_TOKEN`, `ACCESS_TOKEN_SECRET`, `AUTH_TYPE`, `OAUTH2_CLIENT_ID`, `OAUTH2_CLIENT_SECRET`, `OAUTH2_ACCESS_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

X MCP Server

Enhanced MCP server for X with OAuth 2.0 support, media uploads, and comprehensive rate limiting.

Local serverstdioTypeScript

What is the X MCP Server?

X mcp server connects X to AI assistants that speak the Model Context Protocol. Enhanced MCP server for X with OAuth 2.0 support, media uploads, and comprehensive rate limiting.

What X does

An enhanced Model Context Protocol (MCP) server for X that adds OAuth 2.0 support, v2 API media uploads, and comprehensive rate limiting to the original implementation.

Key capabilities

v1.1 — Legacy API, being phased out but still works with OAuth 1.0a
v2 — Modern API with better features but some endpoints have issues
Media — OAuth 2.0 tokens cannot access v1.1 media endpoints, must use v2
Delete — v2 delete endpoint currently has issues (500 errors), v1.1 works as fallback

Practical notes

Maintained by mbelinky, written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
post_tweet	Post a new tweet with optional media attachments and replies.
search_tweets	Example prompts: - "Search for tweets about #MachineLearning" - "Find 50 recent tweets mentioning @ClaudeAI" - "Search for tweets about TypeScript tutorials"
delete_tweet	Example prompts: - "Delete tweet with ID 1234567890" - "Remove my last tweet (provide the ID)"

How to install the X MCP Server

claude mcp add x --env API_KEY=your-value --env API_SECRET_KEY=your-value --env ACCESS_TOKEN=your-value --env ACCESS_TOKEN_SECRET=your-value --env AUTH_TYPE=your-value --env OAUTH2_CLIENT_ID=your-value --env OAUTH2_CLIENT_SECRET=your-value --env OAUTH2_ACCESS_TOKEN=your-value -- npx -y npm

Configuration

Variable	Description	Required
API_KEY	Credential the server authenticates with.	Yes
API_SECRET_KEY	Credential the server authenticates with.	Yes
ACCESS_TOKEN	Credential the server authenticates with.	Yes
ACCESS_TOKEN_SECRET	Credential the server authenticates with.	Yes
AUTH_TYPE	Configuration value read at startup.	Optional
OAUTH2_CLIENT_ID	Configuration value read at startup.	Optional
OAUTH2_CLIENT_SECRET	Credential the server authenticates with.	Yes
OAUTH2_ACCESS_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use X to post tweet.”
“Use X to search tweets.”
“Use X to delete tweet.”

Frequently asked questions

Enhanced MCP server for X with OAuth 2.0 support, media uploads, and comprehensive rate limiting. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.