mcp-reddit

MCP server for scraping Reddit - no API keys required.

Scrapes posts, comments, and media from subreddits and user profiles using old.reddit.com and Libreddit mirrors.

• No API keys - Scrapes directly, no Reddit API credentials needed
• Media downloads - Images, videos with audio (requires ffmpeg)
• Local persistence - Query scraped data offline
• Rich filtering - By post type, score, keywords
• Comments included - Full thread scraping

pip install mcp-reddit

Or with uvx:

uvx mcp-reddit

For local MCP clients like Claude Desktop and Claude Code:

uvx mcp-reddit

For remote MCP clients that connect via URL:

uvx mcp-reddit --http --port 8000

Options:

• --http - Run in HTTP/SSE mode instead of stdio
• --host - Host to bind to (default: 0.0.0.0)
• --port - Port to listen on (default: 8000, or PORT env var)

The server exposes:

• GET /sse - SSE endpoint for MCP connection
• POST /messages/ - Message endpoint
• GET /health - Health check

Add to your Claude Desktop or Claude Code settings:

Claude Desktop doesn't inherit your shell PATH, so you need the full path to uvx:

# Find your uvx path
which uvx

Then use the full path in your config:

{
  "mcpServers": {
    "reddit": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uvx",
      "args": ["mcp-reddit"]
    }
  }
}

Replace /Users/YOUR_USERNAME/.local/bin/uvx with the output from which uvx.

claude mcp add reddit -- uvx mcp-reddit

Or manually in ~/.claude.json:

{
  "mcpServers": {
    "reddit": {
      "command": "uvx",
      "args": ["mcp-reddit"]
    }
  }
}

| Tool | Description