1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@x-mcp show me my timeline" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

x-mcp

by namank42

Overview Schema Related Servers Score Discussions

TypeScript

Remote

x-mcp

A Model Context Protocol (MCP) server for the X (Twitter) API. Built with the official @xdevplatform/xdk SDK and OAuth 2.0 PKCE authentication.

Features

23 tools across users, posts, bookmarks, likes, and lists
OAuth 2.0 PKCE with automatic token refresh
Dual output: markdown (human-readable) or JSON (structured)
MCP tool annotations: readOnlyHint, destructiveHint, idempotentHint

Related MCP server: X MCP Server

Prerequisites

Node.js v18+
pnpm
X API OAuth 2.0 credentials (Client ID and Secret)

Setup

Install dependencies:
```
pnpm install
```

Configure environment:

cp .env.example .env

Edit .env:

X_CLIENT_ID=your_oauth2_client_id
X_CLIENT_SECRET=your_oauth2_client_secret
X_REDIRECT_URI=http://localhost:3000/callback

Authenticate:
```
pnpm run setup-auth
```
Build:
```
pnpm run build
```

Getting X API Credentials

Go to the X Developer Portal
Create a Project and App
Enable OAuth 2.0 in app settings
Set app type to Web App
Add callback URL: http://localhost:3000/callback
Copy Client ID and Client Secret from the OAuth 2.0 section

Claude Desktop Integration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "x-mcp": {
      "command": "node",
      "args": ["/path/to/x-mcp/dist/index.js"],
      "env": {
        "X_TOKENS_PATH": "/path/to/x-mcp/.tokens.json",
        "X_CLIENT_ID": "your_client_id",
        "X_CLIENT_SECRET": "your_client_secret",
        "X_REDIRECT_URI": "http://localhost:3000/callback"
      }
    }
  }
}

Tools

Users

Tool	Description	Parameters
`x_get_user_profile`	Fetch a user profile by username	`username`, `response_format`
`x_get_my_profile`	Get the authenticated user's profile	`response_format`
`x_get_followers`	Get a user's followers	`username`, `limit`, `response_format`
`x_get_following`	Get accounts a user follows	`username`, `limit`, `response_format`

Posts

Tool	Description	Parameters
`x_get_user_posts`	Fetch recent posts from a user (excludes retweets/replies)	`username`, `limit`, `response_format`
`x_get_my_timeline`	Get your home timeline (reverse chronological)	`limit`, `response_format`
`x_search_posts`	Search recent posts (last 7 days)	`query`, `limit`, `response_format`

Bookmarks

Tool	Description	Parameters
`x_get_my_bookmarks`	Fetch your bookmarked posts	`limit`, `response_format`
`x_add_bookmark`	Bookmark a post	`tweet_id`
`x_remove_bookmark`	Remove a bookmark	`tweet_id`

Likes

Tool	Description	Parameters
`x_get_my_likes`	Fetch your liked posts	`limit`, `response_format`
`x_like_post`	Like a post	`tweet_id`
`x_unlike_post`	Unlike a post	`tweet_id`

Lists

Tool	Description	Parameters
`x_get_my_lists`	Get your owned lists	`response_format`
`x_get_list`	Get list details by ID	`list_id`, `response_format`
`x_get_list_posts`	Get posts from a list	`list_id`, `limit`, `response_format`
`x_get_list_members`	Get members of a list	`list_id`, `limit`, `response_format`
`x_create_list`	Create a new list	`name`, `description`, `private`
`x_update_list`	Update a list	`list_id`, `name`, `description`, `private`
`x_delete_list`	Delete a list	`list_id`
`x_add_list_member`	Add a user to a list	`list_id`, `username`
`x_remove_list_member`	Remove a user from a list	`list_id`, `username`

Project Structure

src/
├── index.ts              # MCP server entry point
├── constants.ts          # Shared constants
├── types.ts              # TypeScript interfaces
├── setup-auth.ts         # OAuth 2.0 setup flow
├── schemas/
│   └── common.ts         # Shared Zod schemas
├── services/
│   ├── auth-manager.ts   # OAuth 2.0 token management
│   └── x-client.ts       # X API client wrapper
├── tools/
│   ├── users.ts          # User profile tools
│   ├── tweets.ts         # Post/timeline tools
│   ├── bookmarks.ts      # Bookmark tools
│   ├── likes.ts          # Like tools
│   └── lists.ts          # List management tools
└── utils/
    └── formatting.ts     # Response formatting helpers

Scripts

Command	Description
`pnpm run build`	Compile TypeScript
`pnpm run dev`	Run in development mode
`pnpm start`	Run compiled server
`pnpm run setup-auth`	Authenticate with X
`pnpm run reset-auth`	Reset saved tokens

API Access Tiers

Tier	What works
Free	Post creation, basic read access
Basic ($200/mo)	All read/write endpoints, followers/following
Pro ($5,000/mo)	Higher rate limits, full search

License

MIT

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

X (Twitter) MCP Server
Social Media Communication
Dishant27
A
license
-
quality
D
maintenance
Enables interaction with X (formerly Twitter), allowing for posting tweets, searching content, managing accounts, and organizing lists.
Last updated 2025-04-06
14
3
MIT
X MCP Server
Social Media Communication App Automation
tomaitagaki
F
license
-
quality
D
maintenance
Enables interaction with X (Twitter) API v2 with multi-user OAuth 2.0 support, allowing users to manage bookmarks, create tweets, and access user information with encrypted token storage and automatic refresh.
Last updated 2025-11-08
10
xengager-mcp
Social Media Browser Automation
ogunbaysal
A
license
-
quality
B
maintenance
Provides programmatic X (Twitter) engagement via MCP, offering 24 tools for search, timelines, notifications, bookmarks, profiles, and tweet actions through a headless browser.
Last updated 2026-06-19
MIT
TwitGhost
Social Media Communication
arvinmoj
A
license
B
quality
C
maintenance
Enables interacting with Twitter/X through natural language, including searching tweets, posting, sending DMs, and managing timelines via any MCP client.
Last updated 2026-06-19
8
MIT

View all related MCP servers

Related MCP Connectors

Xquik MCP Server
128 REST operations. 120 MCP routes; 119 JSON/text ops. OAuth 2.1. Not affiliated with X Corp.
excalibur-mcp
FastMCP server for posting formatted content to X (Twitter) — Tollbooth-monetized, DPYC-native
Superpowers.social
Hosted MCP for X/Twitter and Reddit. 12 read-only tools, no API keys, free during beta.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/namank42/x-mcp'

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

x-mcp

Features

Prerequisites

Setup

Getting X API Credentials

Claude Desktop Integration

Tools

Users

Posts

Bookmarks

Likes

Lists

Project Structure

Scripts

API Access Tiers

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

X (Twitter) MCP Server

X MCP Server

xengager-mcp

TwitGhost

Related MCP Connectors

Latest Blog Posts

MCP directory API