← Back to directory
R

Reddit MCP Buddy

Community
Reddit browser for Claude Desktop and AI assistants.
GitHub source repository ↗
★ 805 Stars Category · Other Very popular Source revision 8d31a285db78
33FMRS · D
Reliability
7/20
Security and permissions
5/20
Maintenance
6/20
Documentation
8/20
Setup experience
7/20

Reddit MCP Buddy is a focused Reddit browsing server that requires no API key for basic browsing and offers optional credentials to unlock full features. It provides five core tools, emphasizing real data over generated metrics, with built-in smart caching and rate-limit testing. Main limitations include only stdio transport, official compatibility only with Claude Desktop, and anonymous mode being limited (credentials required for search, comments, and user analysis). Overall, it's a reliable and high-performance server for users wanting to integrate Reddit into AI workflows.

Read the FMRS scoring method →

A Model Context Protocol (MCP) server that enables Claude Desktop and other AI assistants to browse Reddit, search posts, and analyze user activity. Clean, fast, and actually works - browse subreddits with no API keys; add free Reddit credentials for search, comments, user analysis, and full metrics. Supports three authentication tiers (anonymous 10 req/min, app-only 60 req/min, authenticated 100 req/min) with built-in smart caching, privacy protections, and rate-limit testing tools. LLM-optimized with real data only, no fake metrics.

Tools

browse_subreddit
Browse posts from any subreddit with sorting options (hot, new, top, rising, controversial). Supports time ranges, NSFW filtering, and subreddit metadata.
search_reddit
Search Reddit content across all subreddits or specific ones. Filter by author, time range, flair, and sort by relevance, hot, top, new, or comments.
get_post_details
Get detailed information about a Reddit post including full comment threads. Supports comment sorting, depth control, and link extraction.
user_analysis
Analyze a Reddit user's profile including karma, posting history, active subreddits, and activity patterns over different time ranges.
reddit_explain
Get explanations of Reddit terminology, slang, and culture (karma, cake day, AMA, ELI5, etc.) with definitions and usage examples.

Setup

For Claude Desktop: add the config to claude_desktop_config.json: {"mcpServers":{"reddit":{"command":"npx","args":["-y","reddit-mcp-buddy"]}}}. Alternatively, download and open the .mcpb extension file. For Claude Code: run claude mcp add --transport stdio reddit-mcp-buddy -s user -- npx -y reddit-mcp-buddy. Also installable via npm globally or from source.

claude_desktop_config.json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-mcp-buddy"
      ]
    }
  }
}

Fit and risk

Best for

  • Users who want to browse Reddit quickly without setting up API keys
  • AI assistants that need to search and analyze Reddit content for up-to-date info
  • Applications requiring high request rates (up to 100 req/min) or verifiable rate limits
  • Developers and researchers who prefer real data over fake metrics

Not for

  • Users needing write operations (posting, commenting, voting) - server is read-only
  • Users needing native streaming HTTP or SSE transports - only stdio is supported
  • Users needing support for MCP clients other than Claude - official client list only includes Claude Desktop

Required permissions

  • Network access to fetch content from Reddit's public API and RSS feeds
  • Local file storage for optional auth config and cache (credentials are set via environment variables by default)
  • Optional environment variables such as REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD for authentication

Risks and side effects

  • Unauthenticated usage may hit Reddit rate limits (HTTP 429); server retries automatically, but sustained throttling can cause failures
  • HTTP test mode binds to localhost by default; exposing it to your network (REDDIT_BUDDY_HOST=0.0.0.0) poses security risks
  • Anonymous mode fetches from RSS, so scores and comment counts are null - some features require credentials
  • Reddit content may contain inappropriate or offensive material; NSFW filtering only applies when credentials are used

Troubleshooting

  1. Ensure Node.js >= 18 and npm are installed by running `node --version` and `npm --version`
  2. If search/comments/user analysis fail, add Reddit credentials; anonymous mode only supports browsing (RSS) and reddit_explain
  3. If rate limit errors, check auth tier: anonymous 10 req/min, script app credentials up to 100 req/min
  4. If subreddit not found, check spelling (case-insensitive, but must be correct)
  5. If connection issues, check if Reddit is down or firewall blocking requests

Use cases

Check what's trending on Reddit
Search for discussions about a topic
Fetch a post with its comment threads
Analyze a user's Reddit activity
Understand Reddit terminology and slang

Supported clients

Claude DesktopFull support