X Integration MCP Server

Enables interaction with X (formerly Twitter) for retrieving tweets, creating new posts, and replying to existing ones.

Local serverstdioTypeScript★ 73

What is the X Integration MCP Server?

Enables interaction with X (formerly Twitter) for retrieving tweets, creating new posts, and replying to existing ones.

What you get

A Model Context Protocol (MCP) server for X (Twitter) integration. Provides 26 tools for reading timelines, posting, searching, engagement (likes, retweets, bookmarks), user lookup, follower export, mentions, likes, articles, and lists. Designed for use with Claude desktop and other MCP-compatible clients.

  • Timeline & Search — - Home timeline, search recent posts (7-day window)
  • Post Management — - Create, reply, quote, delete posts with optional media
  • Engagement — - Like/unlike, retweet/undo, bookmark/unbookmark
  • User Data — - Mentions, liked posts, followers, following, blocks, mutes, owned lists, followed lists, and list memberships
  • User Lookup — - Get user profiles and their recent posts
  • Media Upload — - Images (PNG, JPEG, GIF, WEBP) and videos (MP4, MOV, AVI, WEBM, M4V) via v2 upload API

Configuration and credentials

  • Node.js >= 18.0.0 - X (Twitter) Developer Account - Claude desktop app (or any MCP-compatible client)

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.

How to install the X Integration MCP Server

{
  "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"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js >= 18.0.0 - X (Twitter) Developer Account - Claude desktop app (or any MCP-compatible client)
VariableDescriptionRequired
TWITTER_API_KEYCredential the server authenticates with.Yes
TWITTER_API_SECRETCredential the server authenticates with.Yes
TWITTER_ACCESS_TOKENCredential the server authenticates with.Yes
TWITTER_ACCESS_SECRETCredential the server authenticates with.Yes
TWITTER_OAUTH2_ACCESS_TOKENCredential the server authenticates with.Yes
TWITTER_CLIENT_IDConfiguration value read at startup.Optional
TWITTER_CLIENT_SECRETCredential the server authenticates with.Yes
TWITTER_OAUTH2_REFRESH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use X Integration to Pay-per.”
  • “Use X Integration to Tier.”
  • “Use X Integration to Free.”

Frequently asked questions

X Integration is a tool that allows you to interact with the X (formerly Twitter) API. You can use it to retrieve tweets, create new posts, reply to existing tweets, and automate your X presence.