EnesCinr/twitter-mcp
A Model Context Protocol server allows to interact with Twitter, enabling posting tweets and searching Twitter.
What it solves
Twitter lacks a simple way for AI assistants to act on your behalf. This server bridges that gap by letting a client like Claude Desktop post tweets, search for tweets, and read your home timeline through a simple configuration.
How it works
It's an MCP (Model Context Protocol) server. You set it up by adding a few lines to your Claude Desktop config file, providing your Twitter API keys. Once running, it exposes three tools:
post_tweet: Can post a new tweet, optionally reply to another tweet, and attach up to 4 images (local JPG, PNG, GIF, or WEBP).search_tweets: Searches for tweets based on your query.get_home_timeline: Returns recent tweets from you and people you follow, in reverse chronological order. You can limit the count (1-100), filter by days (max 30), or give a specific start time (ISO 8601 UTC). Use eithersince_daysorstart_time, not both.
Note: The home timeline tool requires a paid Twitter API tier (Basic or higher) because the free tier does not support the reverse-chronological timeline endpoint.
Who it's for
- Developers and tinkerers who use Claude Desktop and want to connect it to Twitter.
- Anyone who wants to automate tweeting, searching, or monitoring their timeline through natural language commands.
Highlights
- Runs via
npxwith no installation required for users. - Supports posting with images and replies.
- Flexible timeline queries: by count, by recency (days), or by exact timestamp.
- Easy setup: just add credentials to your Claude Desktop config.
- Open source under MIT license.
Related
- Project
- Project
- Project
- Project