# 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

# # Remote MCP (Recommended)

No installation required - connect directly to hosted server:

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

# # Local (npx)

npx -y tweetsave-mcp

# Installation

# # Remote MCP (Recommended)

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:

• Name: TweetSave
• Command: npx
• Arguments: -y mcp-remote https://mcp.tweetsave.org/sse

# # # OpenCode

opencode mcp add

Then follow prompts:

• Name: tweetsave
• Type: Remote
• URL: https://mcp.tweetsave.org/sse
• OAuth: No

# # # 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.

| Parameter | Type | Default | Description |
|- -- -- -- -- --|- -- -- -|- -- -- -- --|- -- -- -- -- -- --|
| url | string | required | Tweet URL or ID |
| response_format | 'markdown' | 'json' | 'markdown' | Output format |

# # tweetsave_get_thread

Fetch a tweet thread (connected tweets).

| Parameter | Type | Default | Description |
|- -- -- -- -- --|- -- -- -|- -- -- -- --|- -- -- -- -- -- --|
| url | string | required | Any tweet URL in thread |
| response_format | 'markdown' | 'json' | 'markdown' | Output format |

# # tweetsave_to_blog

Convert tweet to blog post format.

| Parameter | Type | Default | Description |
|- -- -- -- -- --|- -- -- -|- -- -- -- --|- -- -- -- -- -- --|
| url | string | required | Tweet URL or ID |
| include_engagement | boolean | true | Include likes/retweets |
| response_format | 'markdown' | 'json' | 'markdown' | Output format |

# # tweetsave_batch

Fetch multiple tweets at once.

| Parameter | Type | Default | Description |
|- -- -- -- -- --|- -- -- -|- -- -- -- --|- -- -- -- -- -- --|
| urls | string[] | required | Array of URLs (max 10) |
| response_format | 'markdown' | 'json' | 'markdown' | Output format |

# # tweetsave_extract_media

Extract direct media URLs from a tweet.

| Parameter | Type | Default | Description |
|- -- -- -- -- --|- -- -- -|- -- -- -- --|- -- -- -- -- -- --|
| url | string | required | Tweet 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

• Issues: https://github.com/zezeron/tweetsave-mcp/issues
• Twitter: @zezeron