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. Set all required API keys in the environment variables

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

4. Install dependencies: npm install

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:

# Create a .env file with your X API keys
echo "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" > .env

# Start the server
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

Environment Variables

Repository Structure

twitter-mcp/
├── .github/
│   └── workflows/
│       ├── publish.yml
│       └── release.yml
├── 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
│   ├── twitter-api.ts  # X API client
│   ├── formatter.ts    # Response formatter
│   └── types.ts        # Type definitions
├── .env.example
├── .gitignore
├── Dockerfile
├── LICENSE
├── package.json
├── README.md
└── tsconfig.json

License

MIT