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.

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

Tool Name	Description
post_tweet	Post new content to X
search_tweets	Search for content on X
get_profile	Get profile information for a user or the authenticated account
update_profile	Update the authenticated user's profile
follow_user	Follow a user
unfollow_user	Unfollow a user
list_followers	List followers of a user or the authenticated account
list_following	List accounts that a user or the authenticated account is following
create_list	Create a new list
get_list_info	Get information about a list
get_user_lists	Get all lists owned by the authenticated user

Requirements

• Node.js 18.x or higher
• X Developer account with API keys
• API v1 and v2 access

Environment Variables

Variable	Description
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

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