[TweetSave]
[npm version]
[npm downloads]
[License: MIT]
[MCP Server]
[Claude]
[Server Status]
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
Remote MCP (Recommended)
No installation required - connect directly to hosted server:
Local (npx)
Installation
Remote MCP (Recommended)
Connect to hosted server - no local installation needed.
Claude Code
Claude Desktop / Cursor / Windsurf
Add to your MCP configuration:
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:
Gemini CLI
JetBrains IDEs
Settings → Tools → MCP Server → Add:
OpenCode
Then follow prompts:
Antigravity
Click ... menu → MCP → Manage MCP Server → View raw config:
Local Installation
For offline use or development.
Claude Code
Claude Desktop / Cursor / Windsurf
Available Tools
tweetsave_get_tweet
Fetch a single tweet with all content.
tweetsave_get_thread
Fetch a tweet thread (connected tweets).
tweetsave_to_blog
Convert tweet to blog post format.
tweetsave_batch
Fetch multiple tweets at once.
tweetsave_extract_media
Extract direct media URLs from a tweet.
Output Examples
Markdown Format
Blog Post Format
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