Developer Tools · Social Media

X MCP Server logo

X MCP Server

DataWhisker/x-mcp-server

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.

Install

Client configuration

{
  "mcpServers": {
    "x": {
      "command": "node",
      "args": [
        "<value>"
      ],
      "env": {
        "TWITTER_API_KEY": "<TWITTER_API_KEY>",
        "TWITTER_API_SECRET": "<TWITTER_API_SECRET>",
        "TWITTER_ACCESS_TOKEN": "<TWITTER_ACCESS_TOKEN>",
        "TWITTER_ACCESS_SECRET": "<TWITTER_ACCESS_SECRET>",
        "TWITTER_OAUTH2_ACCESS_TOKEN": "<TWITTER_OAUTH2_ACCESS_TOKEN>"
      }
    }
  }
}

Environment variables

TWITTER_API_KEYTWITTER_API_SECRETTWITTER_ACCESS_TOKENTWITTER_ACCESS_SECRETTWITTER_OAUTH2_ACCESS_TOKEN
GitHub stars
16
Category
Developer Tools, Social Media
License
MIT
Updated
Oct 6, 2026

Features

  • 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

  • Dual Auth - OAuth 1.0a for post operations, OAuth 2.0 for media upload (v1.1 upload was sunset June 2025)

  • Rate Limiting - Automatic per-endpoint rate limit tracking with clear error messages

  • TypeScript - Full type safety, modular file structure

Tools (30)

  • TWITTER_API_KEY

    Consumer Key (API Key)

  • TWITTER_API_SECRET

    Consumer Secret (API Key Secret)

  • TWITTER_ACCESS_TOKEN

    User Access Token

  • TWITTER_ACCESS_SECRET

    User Access Token Secret

  • get_home_timeline

    Get recent posts from home timeline

  • search_tweets

    Search recent posts (7-day window)

  • get_tweet

    Look up a post by ID

  • create_tweet

    Create a post with optional media

  • reply_to_tweet

    Reply to a post with optional media

  • quote_tweet

    Quote a post with commentary

  • delete_tweet

    Delete your post

  • like_tweet

    Like a post (Basic+ tier)

  • unlike_tweet

    Remove a like

  • retweet

    Repost to your timeline

  • undo_retweet

    Remove a repost

  • bookmark_tweet

    Bookmark for later

  • unbookmark_tweet

    Remove a bookmark

  • get_bookmarks

    Get your bookmarks

  • get_user

    Look up user by username

  • get_user_tweets

    Get a user's recent posts

  • get_user_mentions

    Get posts mentioning a user

  • get_user_liked_tweets

    Get a user's liked posts

  • get_user_followers

    Get a user's followers

  • get_user_following

    Get accounts a user follows

  • get_blocking_users

    Get users blocked by the authenticated account

  • get_muting_users

    Get users muted by the authenticated account

  • get_owned_lists

    Get lists owned by a user

  • get_followed_lists

    Get lists followed by a user

  • get_list_memberships

    Get lists a user belongs to

  • get_article

    Fetch the full body content of an X Article post

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
Playwright logo

Playwright

microsoft/playwright

72.2k

Playwright is a framework for web automation and testing. It drives Chromium, Firefox, and WebKit with a single API — in your tests, in your scripts, and as a tool for AI agents.

Developer Tools
repomix logo

repomix

yamadashy/repomix

15.2k

Repomix is a tool that packs a codebase into an AI-friendly format, supporting local and remote repository processing and providing code compression, security checks and multiple output formats.

Developer Tools
UI-TARS-desktop logo

UI-TARS-desktop

bytedance/UI-TARS-desktop

12.9k

TARS is ByteDance's multimodal AI agent stack, shipping two projects: Agent TARS (a CLI and Web UI agent built on MCP) and UI-TARS-desktop (a desktop GUI agent).

Developer Tools
blender logo

blender

ahujasid/blender-mcp

10.6k

formerly blender-mcp — the PyPI package is now mcp-for-blender. Existing setups keep working; no config change is required. Read more.

Developer Tools
Playwright Browser Automation logo

Playwright Browser Automation

microsoft/playwright-mcp

9.2k

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.

Developer Tools
2344 logo

2344

comet-ml/opik

7k

Opik is the open-source LLM observability and evaluation platform for AI agent tracing, LLM evaluation, prompt management, and production monitoring. Built by Comet. Apache-2.0 licensed, free to self-host the full platform, with 20,000+ GitHub stars.

Developer Tools