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

ai-assistantclaudemcpmcp-servermodel-context-protocolredditreddit-apitypescript
View on GitHub ↗
Stars
782★
Forks
95
Language
TypeScript
License
MIT
Created
2025-09-14
Last push
2026-08-04