karanb192/reddit-mcp-buddy
Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.
782 ★95 forksTypeScriptUpdated 3d ago
What you need to know
MCP server that lets Claude Desktop and other AI assistants browse Reddit subreddits, search posts, fetch comments, and analyze user activity — with zero-setup anonymous browsing plus optional free Reddit credentials for higher rate limits.
Install
npx -y reddit-mcp-buddy npm install -g reddit-mcp-buddy claude mcp add --transport stdio reddit-mcp-buddy -s user -- npx -y reddit-mcp-buddy Build from source / Docker: git clone && npm install && npm run build
Usage
- •Add to claude_desktop_config.json with command npx -y reddit-mcp-buddy
- •Optional: set REDDIT_CLIENT_ID / REDDIT_CLIENT_SECRET / REDDIT_USERNAME / REDDIT_PASSWORD env vars for 60-100 req/min tiers
- •Ask about trending posts, search discussions, get post comments, analyze users
Key features
- ✓5 focused tools: browse_subreddit, search_reddit, get_post_details, user_analysis, reddit_explain
- ✓Three-tier auth: anonymous 10 req/min, app-only 60 req/min, authenticated 100 req/min
- ✓Smart caching (50MB cap, per-content TTLs, LRU eviction)
- ✓Read-only — never posts, comments, or modifies Reddit content
- ✓One-click .mcpb Claude Desktop extension; TypeScript, fully typed
Best for
LLM-powered Reddit research: sentiment scanning across subreddits, product reaction checks, and post/comment analysis with no API-key setup.
Caveats
- ⚠Without credentials only browse_subreddit (served from Reddit's public RSS feed, with score/num_comments/upvote_ratio null) and the offline reddit_explain work
- ⚠Anonymous browsing hits Reddit's own per-IP RSS throttle (often one uncached request per 25-60s), so sustained anonymous browsing is slower than 10 req/min
- ⚠100 req/min requires a 'script' app type with username + password
- ⚠HTTP mode (--http) has no authentication — binds to localhost only; exposing 0.0.0.0 is only for trusted networks
Clients: Claude Desktop · Claude Code · any MCP client
Documentation ↗Reviewed 2026-08-07
Topics
- Stars
- 782★
- Forks
- 95
- Language
- TypeScript
- License
- MIT
- Created
- 2025-09-14
- Last push
- 2026-08-04