What is Twitter Client MCP?
Twitter Client MCP is a Model Context Protocol (MCP) server that provides secure access to Twitter functionality through the agent-twitter-client library. It is designed for developers and users who want to let LLM-powered applications (via MCP clients like Cursor) read and write Twitter data while keeping credentials safe.
How to use Twitter Client MCP?
Clone the repository, install dependencies with npm install, and build with npm run build. Set the required environment variables (TWITTER_USERNAME, TWITTER_PASSWORD, TWITTER_EMAIL) and optionally API v2 credentials. Run locally with npm start or use npx to execute directly from GitHub. Configure as a command-type MCP server in your client (e.g., Cursor) pointing to the built index.js, or define it in a .cursor/mcp.json file.
Key features of Twitter Client MCP
- Get profile information by username or for the authenticated user.
- Retrieve a specific tweet by ID or list tweets from a user.
- Post new tweets, like tweets, and retweet tweets.
- Search for tweets with configurable modes (top, latest, photos, videos).
- Search for Twitter profiles by query.
- View a user’s followers, who they follow, and follow new accounts.
Use cases of Twitter Client MCP
- Automate social media monitoring by fetching recent tweets from specific users.
- Build an AI assistant that can post, like, or retweet tweets on your behalf.
- Search for relevant tweets or profiles during a research or marketing campaign.
- Manage your Twitter relationships (follow/unfollow) programmatically.
- Integrate Twitter data into a custom dashboard or chatbot powered by an LLM.
Comments