Twitter MCP Server

What is Twitter MCP Server?

A Twitter integration for AI agents that uses the Model Context Protocol (MCP) standard. Built on the agent-twitter-client library, it provides a consistent interface for reading and interacting with Twitter through MCP-compatible clients like AI assistants.

How to use Twitter MCP Server?

Install dependencies with npm install, build with npm run build, then configure required environment variables (TWITTER_USERNAME, TWITTER_PASSWORD, TWITTER_EMAIL) and optionally Twitter API keys. Add the server to your MCP client configuration (e.g., Claude Desktop) by specifying the path to build/index.js.

Key features of Twitter MCP Server

• Reading tweets, profiles, and search results
• Liking, retweeting, and posting tweets with media
• Creating threads and managing quote tweets
• Fetching trends, timelines, and list tweets
• Following/unfollowing users and viewing relationships
• Media upload support for images (JPEG, PNG, GIF) and video (MP4)
• Rate limiting (max 50 tweets per request on search)

Use cases of Twitter MCP Server

• Fetch recent tweets from a user for analysis
• Search tweets by hashtag or keyword
• Post tweets with text and media attachments
• Create threaded conversations for content campaigns
• Monitor trending topics and timeline activity

FAQ from Twitter MCP Server

What credentials are required?

You need a Twitter username, password, and email. Twitter API keys (API key, API secret key, access token, access token secret) are optional.

What media formats are supported?

Images: JPEG, PNG, GIF. Video: MP4. Alt text is also supported.

How do I install and configure the server?

Run npm install then npm run build. Set the required environment variables and add the server configuration to your MCP client’s JSON config file.

Is there a rate limit?

The search tool enforces a maximum of 50 tweets per request.

How can I debug the server?

Use npm run inspector to launch the MCP Inspector, which provides a URL for debugging in your browser. npm run watch enables auto-rebuild during development.