Skip to main content
Glama

x-mcp

An MCP server and CLI for interacting with X/Twitter, built with @xdevplatform/xdk.

Tools

Tool

Description

post_tweet

Post a tweet

search_tweets

Search recent tweets (last 7 days)

get_user_info

Get user profile info by username(s)

get_timeline

Get your home timeline

like_tweet

Like a tweet by ID

retweet

Retweet a tweet by ID

delete_tweet

Delete a tweet by ID

Related MCP server: TwitterAPI MCP Server

Setup

Prerequisites

You need X/Twitter API credentials (OAuth 1.0a). Get them from the X Developer Portal:

  • API Key (Consumer Key)

  • API Secret (Consumer Secret)

  • Access Token

  • Access Token Secret

Authenticate

Either log in interactively (credentials are saved to ~/.x-mcp/credentials.json):

npx @kms_dev/x-mcp login

Or set environment variables:

export X_API_KEY=your_api_key
export X_API_SECRET=your_api_secret
export X_ACCESS_TOKEN=your_access_token
export X_ACCESS_TOKEN_SECRET=your_access_token_secret

Environment variables take precedence over stored credentials.

Usage

MCP Server

Add to your MCP client config (e.g. Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "x-mcp": {
      "command": "npx",
      "args": ["-y", "@kms_dev/x-mcp"],
      "env": {
        "X_API_KEY": "your_api_key",
        "X_API_SECRET": "your_api_secret",
        "X_ACCESS_TOKEN": "your_access_token",
        "X_ACCESS_TOKEN_SECRET": "your_access_token_secret"
      }
    }
  }
}

If you've already run npx @kms_dev/x-mcp login, you can omit the env block:

{
  "mcpServers": {
    "x-mcp": {
      "command": "npx",
      "args": ["-y", "@kms_dev/x-mcp"]
    }
  }
}

CLI

npx @kms_dev/x-mcp login
npx @kms_dev/x-mcp post-tweet "Hello world!"
npx @kms_dev/x-mcp search-tweets "typescript" --max-results 5
npx @kms_dev/x-mcp get-user-info XDevelopers
npx @kms_dev/x-mcp get-timeline --max-results 10
npx @kms_dev/x-mcp like-tweet 1234567890
npx @kms_dev/x-mcp retweet 1234567890
npx @kms_dev/x-mcp delete-tweet 1234567890

Development

git clone https://github.com/khajaphysist/x-mcp.git
cd x-mcp
npm install

# Run tests
npm test

# Run CLI
npx tsx src/cli.ts search-tweets "test"

# Run MCP server
npx tsx src/mcp-server.ts

# Test MCP server with inspector
npx @modelcontextprotocol/inspector npx tsx src/mcp-server.ts
F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    An MCP server for accessing the Twitter/X Api45 API, allowing users to retrieve user profiles, timelines, followers, and media. It supports searching communities, jobs, and trends, while also providing tools to monitor live broadcasts and Twitter Spaces.
    Last updated
    28
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    An MCP server that provides access to Twitter data and write actions through TwitterAPI.io, bypassing the need for a standard Twitter developer account. It enables users to search tweets, retrieve profiles, and post content with support for pagination and enterprise proxy configurations.
    Last updated
    16
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    An MCP server for interacting with the Twitter/X API v2, enabling AI assistants to retrieve tweets, post content, reply, quote, and more programmatically.
    Last updated
    1,861
    13
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    An MCP server for interacting with Twitter/X using browser cookies without an API key, enabling tweet management, user actions, and search via natural language.
    Last updated
    59
    10
    MIT

View all related MCP servers

Related MCP Connectors

  • FastMCP server for posting formatted content to X (Twitter) — Tollbooth-monetized, DPYC-native

  • A MCP server built for developers enabling Git based project management with project and personal…

  • Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/khajaphysist/x-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server