English Français العربية

io.github.zezeron/tweetsave-mcp

Official registry Marketing and sales

Twitter/X analysis without token waste. Fetch tweets, download media. No API key.

Source code Documentation

What can you do with io.github.zezeron/tweetsave-mcp?

  • Fetch tweets with full content, media, and engagement metrics
  • Convert tweets to formatted blog posts
  • Extract media URLs (photos, videos, GIFs)
  • Batch fetch multiple tweets (up to 10)
  • Support for quote tweets and polls
  • Markdown and JSON output formats

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (sse)
Claude Code 
claude mcp add --transport sse tweetsave-mcp 'https://mcp.tweetsave.org/sse'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tweetsave-mcp": {
            "type": "sse",
            "url": "https://mcp.tweetsave.org/sse"
        }
    }
}
NPM package tweetsave-mcp
Claude Code 
claude mcp add tweetsave-mcp -- npx -y tweetsave-mcp@1.0.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tweetsave-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "tweetsave-mcp@1.0.3"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Features
  2. Quick Start
  3. Installation
  4. Available Tools
  5. Output Examples
  6. Limitations
  7. License
  8. Contributing
  9. Support

MCP server for fetching Twitter/X content and converting to blog posts.

No Twitter API key required - Uses FxTwitter API (free, open source).

Website • Quick Start • Features • Installation • Tools

Features

  • Fetch tweets with full content, media, and engagement metrics
  • Convert tweets to formatted blog posts
  • Extract media URLs (photos, videos, GIFs)
  • Batch fetch multiple tweets (up to 10)
  • Support for quote tweets and polls
  • Markdown and JSON output formats

Quick Start

No installation required - connect directly to hosted server:

npx -y mcp-remote https://mcp.tweetsave.org/sse
Local (npx)
npx -y tweetsave-mcp

Installation

Connect to hosted server - no local installation needed.

Claude Code
# Global (all projects)
claude mcp add -s user tweetsave -- npx -y mcp-remote https://mcp.tweetsave.org/sse

# Project only
claude mcp add tweetsave -- npx -y mcp-remote https://mcp.tweetsave.org/sse
Claude Desktop / Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "tweetsave": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tweetsave.org/sse"]
    }
  }
}

Config file locations:

  • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
  • Cursor: ~/.cursor/mcp.json
  • Windsurf: ~/.codeium/windsurf/mcp_config.json
VS Code

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "tweetsave": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tweetsave.org/sse"]
    }
  }
}
Gemini CLI
gemini mcp add tweetsave "npx -y mcp-remote https://mcp.tweetsave.org/sse"
JetBrains IDEs

Settings → Tools → MCP Server → Add:

OpenCode
opencode mcp add

Then follow prompts:

Antigravity

Click ... menu → MCP → Manage MCP Server → View raw config:

{
  "mcpServers": {
    "tweetsave": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tweetsave.org/sse"]
    }
  }
}
Local Installation

For offline use or development.

Claude Code
# Global (all projects)
claude mcp add -s user tweetsave -- npx -y tweetsave-mcp

# Project only
claude mcp add tweetsave -- npx -y tweetsave-mcp
Claude Desktop / Cursor / Windsurf
{
  "mcpServers": {
    "tweetsave": {
      "command": "npx",
      "args": ["-y", "tweetsave-mcp"]
    }
  }
}

Available Tools

tweetsave_get_tweet

Fetch a single tweet with all content.

ParameterTypeDefaultDescription
urlstringrequiredTweet URL or ID
response_format'markdown' \'json''markdown'Output format
tweetsave_get_thread

Fetch a tweet thread (connected tweets).

ParameterTypeDefaultDescription
urlstringrequiredAny tweet URL in thread
response_format'markdown' \'json''markdown'Output format
tweetsave_to_blog

Convert tweet to blog post format.

ParameterTypeDefaultDescription
urlstringrequiredTweet URL or ID
include_engagementbooleantrueInclude likes/retweets
response_format'markdown' \'json''markdown'Output format
tweetsave_batch

Fetch multiple tweets at once.

ParameterTypeDefaultDescription
urlsstring[]requiredArray of URLs (max 10)
response_format'markdown' \'json''markdown'Output format
tweetsave_extract_media

Extract direct media URLs from a tweet.

ParameterTypeDefaultDescription
urlstringrequiredTweet URL or ID
media_type'all' \'photos' \'videos''all'Filter type

Output Examples

Markdown Format
## @itsPaulAi (Paul Couvert)

This is so good 🔥

You can run this new model on a laptop which is:
- 100% open source
- Only 3B active parameters (!!)

---
**Engagement**: 228 likes | 15 retweets | 29.9K views
**Posted**: January 19, 2026 at 08:02 PM
Blog Post Format
# This is so good 🔥 You can run this new model...

*A post by @itsPaulAi*

**Author**: Paul Couvert ([@itsPaulAi](https://x.com/itsPaulAi))
**Published**: January 19, 2026 at 08:02 PM
**Read time**: 1 min read

---

[Content here]

---

## Engagement

- **Likes**: 228
- **Retweets**: 15
- **Views**: 29.9K

Limitations

  • No replies/comments: FxTwitter API doesn't support fetching replies
  • Rate limits: FxTwitter has rate limits for heavy usage
  • Private tweets: Cannot access protected/private accounts

License

MIT

Contributing

Contributions welcome! Please open an issue or PR.

Support

Frequently asked questions

What is io.github.zezeron/tweetsave-mcp?

Twitter/X analysis without token waste. Fetch tweets, download media. No API key.

How do I install io.github.zezeron/tweetsave-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport sse tweetsave-mcp 'https://mcp.tweetsave.org/sse'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.zezeron/tweetsave-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.zezeron/tweetsave-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.zezeron/tweetsave-mcp?

It is published by zezeron. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.