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 either since_days or start_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 npx with 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