X (Twitter) MCP Server

This MCP server allows Clients to interact with X (formerly Twitter), enabling comprehensive platform operations including posting tweets, searching content, managing accounts, and organizing lists.

Quick Start

1. Create an X Developer account and get your API keys from X Developer Portal

2. Clone this repository: git clone https://github.com/Dishant27/twitter-mcp.git

3. Install dependencies and build: npm install && npm run build

4. Set your API keys, either as environment variables or in a .env file (copy .env.example to .env and fill in your values; .env is git-ignored, so never commit it)

5. Run the server:

• With environment variables:

TWITTER_API_KEY=your_api_key \
TWITTER_API_SECRET=your_api_secret \
TWITTER_ACCESS_TOKEN=your_access_token \
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret \
npm start

• Using a .env file:

cp .env.example .env
# edit .env with your own keys, then:
npm start

6. Use with a MCP client, such as Claude.

Related MCP server: Twitter MCP Server

Claude Configuration

To use this server with Claude, you'll need to set up the MCP configuration. Here's an example of how the configuration structure should look:

{
  "name": "x",
  "display_name": "X",
  "description": "X MCP allows Claude to interact with X (formerly Twitter)",
  "path": "path/to/twitter-mcp/dist/index.js",
  "startup": {
    "env": {
      "TWITTER_API_KEY": "your_api_key",
      "TWITTER_API_SECRET": "your_api_secret",
      "TWITTER_ACCESS_TOKEN": "your_access_token",
      "TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret"
    }
  },
  "transport": "stdio"
}

Save this configuration in your Claude MCP config directory, typically located at:

• Windows: %APPDATA%\AnthropicClaude\mcp-servers

• macOS: ~/Library/Application Support/AnthropicClaude/mcp-servers

• Linux: ~/.config/AnthropicClaude/mcp-servers

Features

Post Operations

• Post content (up to 280 characters)

• Search for posts by query with customizable result count

Account Management

• Get profile information for any user or the authenticated account

• Update profile details (name, bio, location, website URL)

• Follow and unfollow users

• List followers for any user or the authenticated account

• List accounts that a user is following

List Management

• Create new lists (public or private)

• Get information about specific lists

• Retrieve all lists owned by the authenticated user

Available MCP Tools

Requirements

• Node.js 18.x or higher

• X Developer account with API keys

• API v1 and v2 access

Built on @modelcontextprotocol/sdk 1.x (the McpServer / registerTool API with zod input schemas). It runs over stdio, so stdout is reserved for the MCP protocol and all logs go to stderr.

Environment Variables

All four are required; the server exits at startup if any is missing. See .env.example.

Development

npm run build   # compile TypeScript to dist/
npm run smoke   # start the built server with placeholder keys and check it lists its 11 tools (no X API calls)

CI (.github/workflows/ci.yml) runs npm ci, a type check, the build and the smoke test on pushes and pull requests to master.

Repository Structure

twitter-mcp/
├── .github/
│   └── workflows/
│       └── ci.yml      # Build + smoke test
├── code/
│   ├── account_management.py  # Sample Python code for account management
│   ├── post_tweet.py          # Sample Python code for posting content
│   └── retrieve_tweets.py     # Sample Python code for retrieving content
├── src/
│   ├── index.ts        # Main entry point (MCP server and tools)
│   ├── twitter-api.ts  # X API client
│   ├── formatter.ts    # Response formatter
│   └── types.ts        # Type definitions
├── test/
│   └── smoke.mjs       # Stdio smoke test
├── .env.example
├── .gitignore
├── LICENSE
├── package.json
├── package-lock.json
├── README.md
└── tsconfig.json

License

MIT