# tweetsave-mcp

tweetsave-mcp grabs tweets with text, media, and engagement stats, converts them to blog posts, and extracts direct media URLs. Runs on FxTwitter API — no token needed.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: zezeron
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zezeron/tweetsave-mcp
- Updated: 2026-04-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tweetsave-mcp

## What it does

The server provides five tools: `tweetsave_get_tweet` pulls a single tweet, `tweetsave_get_thread` collects entire threads, `tweetsave_to_blog` reformats a tweet as an article with headline and read time, `tweetsave_batch` retrieves up to ten tweets in one call, `tweetsave_extract_media` extracts image and video URLs. Output is markdown or JSON; engagement metrics can be toggled off. It relies on FxTwitter, so private accounts are off-limits and heavy usage may hit rate caps.

Both remote (`https://mcp.tweetsave.org/sse`) and local (`npx`) variants are supported. Remote skips installation; local works offline.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.tweetsave.org/sse`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport sse tweetsave-mcp https://mcp.tweetsave.org/sse
```

2. **Platform CLI**
```bash
claude mcp add tweetsave-mcp -- npx -y tweetsave-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add tweetsave-mcp -- npx -y tweetsave-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tweetsave-mcp": {
            "url": "https://mcp.tweetsave.org/sse"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tweetsave-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "tweetsave-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tweetsave-mcp": {
            "type": "sse",
            "url": "https://mcp.tweetsave.org/sse"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tweetsave-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "tweetsave-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t sse tweetsave-mcp https://mcp.tweetsave.org/sse
```

2. **Platform CLI**
```bash
gemini mcp add tweetsave-mcp npx -y tweetsave-mcp
```

## When to use it
- pull tweet text, images, and metrics without X API credentials
- collect a thread of connected tweets in one command
- reformat a tweet into a ready blog post with title and timestamp
- extract direct media file URLs from tweets or threads
- batch-fetch multiple tweets in a single request

## Example prompts
- Fetch text and stats for tweet `1234567890123456789`
- Collect the entire thread starting from this tweet URL in markdown
- Turn this tweet into blog format without engagement numbers

## Similar
- [fetch-tweet](https://affpapa.org/en/nevibecode/skills/fetch-tweet.md) — skill · 901 installs
- [DevHub CMS](https://affpapa.org/en/nevibecode/mcp/devhub-cms.md) — MCP server
- [building-journalist-outreach-list-from-twitter](https://affpapa.org/en/nevibecode/skills/building-journalist-outreach-list-from-twitter.md) — skill · 950 installs
- [monitoring-twitter-for-competitor-job-posts](https://affpapa.org/en/nevibecode/skills/monitoring-twitter-for-competitor-job-posts.md) — skill · 944 installs
- [x-twitter-scraper](https://affpapa.org/en/nevibecode/skills/davepoon-x-twitter-scraper.md) — skill · 107 installs
- [social-superpowers](https://affpapa.org/en/nevibecode/mcp/social-superpowers.md) — MCP server · 9761 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
