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",