Log inSubmit server
Reddit MCP Buddy logo

Reddit MCP Buddy

by karanb192

Browse Reddit, search discussions, inspect posts and comments, analyze users, and explain Reddit terminology through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Reddit MCP Buddy

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "karanb192-reddit-mcp-buddy": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-mcp-buddy"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

karanb192/reddit-mcp-buddy MCP server gives AI assistants access to Reddit browsing, search, post details, user analysis, and terminology explanations. It can browse subreddit feeds anonymously through public RSS when available, while search, comments, user analysis, and engagement metrics require approved Reddit API credentials. The server runs over standard MCP transports, with setup options for Claude Desktop, Claude Code, npm-based clients, Docker, and a desktop extension. Reach for it when an agent needs Reddit context or community activity data without building a separate Reddit client.

Use cases

  • Browse trending posts from a subreddit or across Reddit
  • Search discussions by topic, author, time, or flair
  • Retrieve a post with its comment thread
  • Analyze a user's Reddit history and activity
  • Explain Reddit slang and community terminology

Key features

  • Anonymous subreddit browsing through public RSS feeds
  • Reddit API-backed search, comments, user analysis, and metrics
  • Post retrieval from URLs or IDs with comment controls
  • Reddit terminology explanations with examples
  • Optional post and comment creation with confirmation controls
  • Configurable local request-rate caps

Tools5

What Reddit MCP Buddy lets your agent do. Expand a tool for its parameters.

Verified live~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/21 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · reddit-mcp-buddy (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars865Stargazers on the source repository.
npm downloads6.6kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Tools exposed5Callable tools this server registers over MCP.
Directory activity1 upvotesConfig copies, upvotes, and views on AllMCPs.

How Reddit MCP Buddy works

What karanb192/reddit-mcp-buddy MCP server does

Reddit MCP Buddy exposes Reddit-focused tools to MCP-compatible AI assistants. It covers subreddit browsing, Reddit-wide or subreddit-specific search, post and comment retrieval, user activity analysis, and explanations of Reddit vocabulary and culture. Read-only installations provide five tools: browse_subreddit, search_reddit, get_post_details, user_analysis, and reddit_explain.

An optional posting mode adds tools for creating posts, adding comments, and checking subreddit rules. Posting is opt-in and includes a client-dependent confirmation flow, per-process limits, and duplicate suppression.

How it works

The server uses Reddit's public RSS feeds for anonymous subreddit browsing when those feeds are available. RSS results identify their source with data_source: "rss"; score, comment count, upvote ratio, and NSFW values are null in that mode. Reddit API credentials change the source to api and provide the corresponding engagement fields.

API access is required for search, post details, user analysis, and full metrics. Reddit approval is handled by Reddit and must be obtained for the application's use case. Local request caps are configured at 10, 60, or 100 requests per minute, in addition to Reddit's own limits.

Setup and configuration

The simplest Claude Desktop installation uses the downloadable .mcpb desktop extension. An npm-based setup can run the package with npx -y reddit-mcp-buddy as an MCP server command. Claude Code can add the same stdio server with its claude mcp add command. Other MCP clients can use the npm command according to their MCP configuration format.

Anonymous browsing needs no credentials, although RSS may be blocked or throttled. For API-backed capabilities, configure the approved Reddit application's client ID, client secret, username, and password through REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, and REDDIT_PASSWORD. Reddit app approval and access policies apply separately from this server.

Tools and capabilities

  • browse_subreddit retrieves posts from all, popular, or a named subreddit. Sorting supports hot, new, top, rising, and controversial, with time ranges for top and controversial views.
  • search_reddit searches across Reddit or within selected subreddits, with filters for author, time, and flair and sorting by relevance, hot, top, new, or comments.
  • get_post_details returns a post and its comments from a Reddit URL or post ID. It supports common Reddit URL variants, comment sorting, depth selection, and link extraction.
  • user_analysis reports a user's karma, posts, comments, active subreddits, and activity statistics.
  • reddit_explain defines Reddit terms such as karma, cake day, AMA, and ELI5, including origin, usage, and examples.

Limitations and notes

RSS browsing does not provide reliable popularity metrics or NSFW filtering, so null values must not be interpreted as zero or as evidence of low engagement. Supplying only a post ID causes an extra subreddit lookup; providing the subreddit with the ID uses one API call instead. API access depends on Reddit approval, and Reddit may impose additional rate limits. Write tools appear only when posting is enabled; read-only configurations expose the five read tools above.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Reddit MCP Buddy

karanb192/reddit-mcp-buddy is an MCP server that connects AI assistants to Reddit. Its main tools browse subreddits, search posts, retrieve posts with comments, analyze user activity, and explain Reddit terminology. Anonymous browsing can use public RSS, while API credentials enable search, detailed posts, user analysis, and full metrics.

Install it through the Claude Desktop extension, npm with `npx -y reddit-mcp-buddy`, or Claude Code's `claude mcp add` command. Other MCP clients can run the same npm command through their stdio server configuration.

No, credentials are not required for subreddit browsing when Reddit's public RSS feeds are available. API credentials are required for search, post details, user analysis, and full engagement metrics.

Call `get_post_details` with a Reddit URL or post ID. When using an ID, also provide the subreddit if it is known to avoid the additional lookup request. The tool supports comment sorting, depth, and link extraction options.

Yes, but only when its optional posting mode is enabled. That mode exposes post creation, comment addition, and subreddit-rule tools, and uses client-dependent confirmation, per-process caps, and duplicate suppression.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewReddit MCP Buddy AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/karanb192-reddit-mcp-buddy?style=directory)](https://allmcps.com/mcp/karanb192-reddit-mcp-buddy)
HTML Embed
<a href="https://allmcps.com/mcp/karanb192-reddit-mcp-buddy"><img src="https://allmcps.com/api/badge/karanb192-reddit-mcp-buddy?style=directory" alt="Reddit MCP Buddy on AllMCPs" /></a>