MCP Twitter

Description

MCP Twitter is a server based on the Model Context Protocol that allows direct interaction with Twitter/X. It exposes various Twitter API functionalities through a standardized set of tools, enabling AI models and applications to perform actions on Twitter.

Features

This MCP server provides the following actions:

• create_twitter_post: Create a new X/Twitter post
• reply_twitter_tweet: Reply to a specific X/Twitter post by ID
• get_last_tweet: Get the most recent post from a specified X/Twitter account
• get_last_tweets_options: Get a specified number of posts matching a search query
• create_and_post_twitter_thread: Create and publish an X/Twitter thread
• follow_twitter_from_username: Follow an X/Twitter user by username
• get_twitter_profile_from_username: Get complete X/Twitter profile data by username
• get_twitter_user_id_from_username: Get X/Twitter user ID from username
• get_last_tweet_and_replies_from_user: Get recent X/Twitter posts and replies from a user
• get_last_tweet_from_user: Get recent X/Twitter posts from a user
• get_own_twitter_account_info: Get current account profile data

Installation and Usage

Local Installation

# Clone the repository
git clone https://github.com/0xhijo/mcp_twitter.git

# Install dependencies and build the project
pnpm build

# Launch the server
node ./build/index.js

Installation via NPX

npx mcp_twitter

Configuration

Configuration via Twitter Scraper

1. Configure the .env file:

TWITTER_AUTH_MODE = "CREDENTIALS" # Credentials mode

# Your Twitter credentials

TWITTER_USERNAME="YOUR_TWITTER_USERNAME"
TWITTER_PASSWORD="YOUR_TWITTER_PASSWORD"
TWITTER_EMAIL="YOUR_TWITTER_EMAIL"

You need to configure Twitter authentication by creating a .env file or directly adding the variables to your environment.

Configuration via Twitter API

1. Create a Developer Account:

Make sure you have a Twitter account Visit the Developer Platform Get your API credentials Follow this guide if you need help creating your developer account

2. Configure the .env file

TWITTER_AUTH_MODE = "API" # API mode

# Your CREDENTIALS obtained from the Developer Platform

TWITTER_API="YOUR_TWITTER_API"
TWITTER_API_SECRET="YOUR_TWITTER_API_SECRET"
TWITTER_ACCESS_TOKEN="YOUR_TWITTER_ACCESS_TOKEN"
TWITTER_ACCESS_TOKEN_SECRET="YOUR_TWITTER_ACCESS_TOKEN_SECRET"

Integrating with Claude

To use MCP Twitter with Claude, you need to add it to your claude_mcp_config.json file. This will allow Claude to interact with Twitter through the MCP server.

Adding to Claude's MCP Configuration

Add the following entry to your claude_mcp_config.json file:

"mcp_twitter": {
  "command": "npx",
  "args": ["mcp_twitter"],
  "env": {
    "TWITTER_AUTH_MODE": "CREDENTIALS",
    "TWITTER_USERNAME": "YOUR_TWITTER_USERNAME",
    "TWITTER_PASSWORD": "YOUR_TWITTER_PASSWORD",
    "TWITTER_EMAIL": "YOUR_TWITTER_EMAIL"
  }
}

Replace the placeholder credentials with your actual Twitter account information. This configuration will launch the MCP Twitter server using npx when Claude needs to interact with Twitter.

Usage with Claude

Once configured, Claude will be able to use all the Twitter functionalities provided by the MCP server, such as creating posts, retrieving tweets, and more. You can simply ask Claude to perform Twitter actions, and it will utilize the MCP server to execute them.

Important Notes

• Choose the authentication mode (API or CREDENTIALS) based on your needs
• Verify that your credentials are properly configured in the .env file
• Check the official documentation for more details about API limitations