agent-twitter-client-mcp
About
A Model Context Protocol (MCP) server that integrates with X using the @elizaOS `agent-twitter-client` package, allowing AI models to interact with Twitter without direct API access.
Details
- Author
- ryanmac
- GitHub stars
- 31
- Downloads
- 510
- Categories
- AI
Jump to
- Cookie-based, username/password, or Twitter API v2 authentication
- Fetch, search, post, like, retweet, and quote tweets
- Create polls with multiple options and duration
- Get user profiles, follow users, and list followers/following
- Chat with Grok via Twitter's interface with conversation continuity
- Health check endpoint for server status
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
agent-twitter-client-mcpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install globally or locally via npm, create a .env file with Twitter credentials (cookies, username/password, or API), and run the server with agent-twitter-client-mcp or npx agent-twitter-client-mcp. Configure it with Claude Desktop by adding the server to the MCP config file with the chosen authentication method. An interactive test CLI is also available via npx agent-twitter-client-mcp-test.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"agent-twitter-client-mcp": {
"agent-twitter-client-mcp": {
"command": "npx",
"args": [
"agent-twitter-client-mcp"
]
}
}
}
}McpServers
{
"agent-twitter-client-mcp": {
"command": "npx",
"args": [
"agent-twitter-client-mcp"
]
}
}agent-twitter-client-mcp
A Model Context Protocol (MCP) server that integrates with Twitter using the agent-twitter-client package, allowing AI models to interact with Twitter without direct API access.
Features
- Authentication Options:
- Cookie-based authentication (recommended)
- Username/password authentication
- Twitter API v2 credentials
- Tweet Operations:
- Fetch tweets from users
- Get specific tweets by ID
- Search tweets
- Send tweets with text and media
- Create polls
- Like, retweet, and quote tweets
- User Operations:
- Get user profiles
- Follow users
- Get followers and following lists
- Grok Integration:
- Chat with Grok via Twitter's interface
- Continue conversations with conversation IDs
- Get web search results and citations
- Access Twitter's real-time data through Grok
- Note: Grok functionality requires agent-twitter-client v0.0.19 or higher
Documentation
- Developer Guide - Comprehensive guide for developers
- Testing Guide - Instructions for testing the MCP
- Agent Guide - Guide for AI agents on how to use the Twitter MCP
- Contributing Guide - Guidelines for contributing to this project
- Changelog - History of changes to this project
- Demo README - Guide for running the demo scripts
- Grok Examples - Documentation for the Grok AI integration examples
Quick Start
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
