A
securityA
licenseA
qualityEnables interaction with Twitter through a Model Context Protocol, allowing large language models to post tweets, search for tweets, and reply to tweets.
Last updated -
53
1
22
MIT License
Supported as a platform for the MCP server, with specific configuration paths provided for macOS users.
Used for package management and running server scripts, facilitating installation and development workflows.
The server uses TypeScript for its response format, providing strongly typed structure for communication between the client and server.
Twitter MCP Server
A powerful Twitter integration for AI agents that leverages the Model Context Protocol (MCP) standard, providing a comprehensive set of Twitter functionality through a clean and consistent interface.
Overview
This server provides access to Twitter's features through MCP tools, allowing seamless integration with AI assistants and other MCP-compatible clients. It's built on top of the agent-twitter-client library and provides robust error handling, rate limiting, and consistent response formatting.
Features
Basic Reading
Get tweets from users with media support
Fetch user profiles with detailed information
Search tweets by hashtags or keywords
Filter search results by latest/top
Rate limiting (max 50 tweets per request)
User Interactions
Like/Unlike tweets
Retweet/Undo retweet
Post tweets with:
Text content
Media attachments (images, videos)
Reply functionality
Quote tweet capability
Advanced Features
Get user relationships (followers/following)
Fetch trending topics
Access different timeline types:
Home timeline
Following timeline
User timeline
List management (fetch list tweets)
Media & Advanced Interactions
Media handling:
Image upload (JPEG, PNG, GIF)
Video upload (MP4)
Alt text support
Thread creation
Follow/Unfollow users
Tools
Reading Tools
get_tweets- Fetch recent tweets from a userget_profile- Get a user's profile informationsearch_tweets- Search for tweets by hashtag or keyword
Interaction Tools
like_tweet- Like or unlike a tweetretweet- Retweet or undo retweetpost_tweet- Post a new tweet with optional mediacreate_thread- Create a Twitter thread
Timeline Tools
get_timeline- Get tweets from different timeline typesget_list_tweets- Get tweets from a Twitter listget_trends- Get current trending topics
User Management Tools
get_user_relationships- Get followers or following listfollow_user- Follow or unfollow a user
Installation
Install dependencies:
npm install
Build the server:
npm run build
Configure environment variables:
# Required: Twitter Account Credentials (for user authentication)
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email
# Twitter API Authentication (Optional)
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret
Add the server config to your MCP client:
On MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
On Windows:
%APPDATA%/Claude/claude_desktop_config.json
Configuration:
{
"mcpServers": {
"twitter-mcp-server": {
"command": "/path/to/twitter-mcp-server/build/index.js"
}
}
}
Development
For development with auto-rebuild:
npm run watch
Debugging
Since MCP servers communicate over stdio, you can use the MCP Inspector for debugging:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
Error Handling
The server implements comprehensive error handling:
Input validation for all parameters
Rate limiting protection
Detailed error messages
Proper error propagation
Logging for debugging
Response Format
All tools return responses in a consistent format:
{
content: [{
type: "text",
text: string // JSON stringified response or error message
}]
}
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT License - see LICENSE file for details
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables AI to interact with Twitter, allowing functions like searching tweets, comparing sentiments across accounts, and retrieving timeline content.Last updated -MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI models and applications to interact directly with Twitter/X, providing capabilities to create posts, reply to tweets, retrieve user data, and manage account actions.Last updated -611MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with Twitter without direct API access, supporting tweet operations, user interactions, and Grok AI integration.Last updated -1118MIT License