What is Mcp Twitter

mcp_twitter is a server based on the Model Context Protocol that facilitates direct interaction with the Twitter/X platform, allowing AI models and applications to utilize various Twitter API functionalities.

Use cases

Use cases include automating tweet posting, analyzing user engagement, managing Twitter accounts, and developing applications that require real-time Twitter data.

How to use

To use mcp_twitter, clone the repository, install dependencies, and run the server. You can also use it via NPX for quick access. Configuration is required for Twitter authentication, either through credentials or the Twitter API.

Key features

Key features include creating and posting tweets, replying to tweets, retrieving recent tweets, following users, and accessing user profile information.

Where to use

mcp_twitter can be used in social media management, AI-driven applications, data analysis, and any project requiring interaction with Twitter/X functionalities.

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:

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