← Back to directory
R

Reddit MCP Buddy

Community
Reddit browser for Claude Desktop and AI assistants.
Category
Other #213 of 230
Stars
★ 849 Very popular
Transport
stdio (local process)
Runtime
Node.js 18+ · Docker
Credentials
Optional API key
License
MIT
Last commit
Tools
5
33FMRS · D

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.

Strongest · Documentation 8/20 Weakest · Security and permissions 5/20

Reliability
7/20
Security and permissions
5/20
Maintenance
6/20
Documentation
8/20
Setup experience
7/20
Why each score
Reliability 7/20
Evidence: The README and manifest list 5 tools, but no actual server source code (no src/, package.json, tests etc.) is provided for verification. The claimed anonymous and authenticated modes, RSS fallback, and caching logic cannot be verified. No CI or test evidence is present. Therefore, per static calibration, reliability cannot exceed 12; but lacking concrete proof of actual behavior, I infer the happy path may work but error handling and dependency control are unverified, so score is low. Deductions: no source code, no tests, no CI evidence.
Security and permissions 5/20
Evidence: Credentials are handled via env vars or local file (--auth), with promises that passwords are never written to disk and tokens are memory-only. HTTP mode binds to localhost by default with host/origin checks. However, no source code is provided to verify these claims. Anonymous mode uses RSS, no obvious risk. No red flags found. Deductions: unable to verify security implementation; lack of explicit statement about HTTPS in transit; no evidence of log redaction for secrets.
Maintenance 6/20
Evidence: Repo shows active releases (1.1.14) and relatively high stars, but no commit history, issue response times, or dependency update details are provided. MIT license present. Without specific evidence, maintenance activity is scored moderate-low. Deductions: no commit/release history, issue resolution times, or dependency update records.
Documentation 8/20
Evidence: README is very detailed, covering installation, auth, tool parameters, rate limits, troubleshooting, privacy policy, env vars, and comparisons. Examples and expected outputs (like data_source) are explained. Deductions: lack of detailed examples of actual tool output JSON structures; documentation heavily relies on GIF demos without static screenshots for verification.
Setup experience 7/20
Evidence: README provides multiple installation methods (npx, global, from source, Docker, .mcpb). Clear JSON config examples for Claude Desktop are given. For other clients, npx -y command is provided. Deductions: no verification that install steps work out-of-the-box in a specific client; dependencies on node version and network; no example config file or step-by-step verification screenshots.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

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

Setup

Before you start

Runtime:Node.js 18+ · Docker

REDDIT_CLIENT_SECRET optionalsecret The Reddit app's secret; paired with the Client ID enables 60 req/min app-only mode; treat as sensitive.
REDDIT_PASSWORD optionalsecret Reddit account password; used only in-memory for OAuth token exchange, never written to disk; sensitive.
Other optional settings (9)
REDDIT_CLIENT_ID optional Client ID from a Reddit app created at reddit.com/prefs/apps; optional, unlocks search and analysis features.
REDDIT_USERNAME optional Reddit account username; combined with password enables the 100 req/min authenticated tier.
REDDIT_USER_AGENT optional Custom user agent string; applies only when credentials are configured.
REDDIT_BUDDY_HTTP optional Set to true to run as an HTTP server instead of the default stdio mode.
REDDIT_BUDDY_PORT optional HTTP server port, defaults to 3000.
REDDIT_BUDDY_HOST optional Network interface the HTTP server binds to, defaults to 127.0.0.1.
REDDIT_BUDDY_ALLOWED_ORIGINS optional Comma-separated browser origins allowed to call the HTTP endpoint.
REDDIT_BUDDY_ALLOWED_HOSTS optional Comma-separated host:port values accepted in the Host header (DNS-rebinding protection).
REDDIT_BUDDY_NO_CACHE optional Set to true to disable in-memory caching and always fetch fresh data.

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"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "reddit": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-mcp-buddy"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add reddit -- npx -y reddit-mcp-buddy

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

Add npx -y reddit-mcp-buddy to your Claude Desktop config and restart; the client should list the five tools including browse_subreddit and search_reddit. Asking "What's trending on Reddit?" and getting real posts confirms the connection works.

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

Things to try

Once connected, you can ask your AI assistant things like:

  • What's trending on Reddit right now?
  • Search for top discussions about GPT-4 today
  • Analyze Reddit user spez's posting history and active subreddits
  • Explain what Reddit karma means

Tools 5

browse_subreddit read-only
Browse posts from any subreddit with sorting options (hot, new, top, rising, controversial). Supports time ranges, NSFW filtering, and subreddit metadata.
search_reddit read-only
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 read-only
Get detailed information about a Reddit post including full comment threads. Supports comment sorting, depth control, and link extraction.
user_analysis read-only
Analyze a Reddit user's profile including karma, posting history, active subreddits, and activity patterns over different time ranges.
reddit_explain read-only
Get explanations of Reddit terminology, slang, and culture (karma, cake day, AMA, ELI5, etc.) with definitions and usage examples.

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 Desktop

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 653 · Tools 11 Compare with this →

Source revision 8d31a285db78 Data synced 2026-10-11 Read the FMRS scoring method