Reddit Buddy

v1.1.12Search & Data Extractionstable

Enables AI assistants to browse Reddit, search posts, analyze user activity, and fetch comments without requiring API keys. Features smart caching, clean data responses, and optional authentication for higher rate limits.

ai-assistantclaudemcpmcp-servermodel-context-protocol
Share:
654
Stars
0
Downloads
0
Weekly
0/5

What is Reddit Buddy?

Reddit Buddy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to browse reddit, search posts, analyze user activity, and fetch comments without requiring api keys. features smart caching, clean data responses, and optional authentication fo...

Enables AI assistants to browse Reddit, search posts, analyze user activity, and fetch comments without requiring API keys. Features smart caching, clean data responses, and optional authentication for higher rate limits.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables AI assistants to browse Reddit, search posts, analyz

Use Cases

Browse Reddit and search posts for topics without API complexity. Analyze user activity and fetch comments with optional authentication. Leverage Reddit data with smart caching and clean responses.
karanb192

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.1.12
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y reddit-mcp-buddy

Manual Installation

npx -y reddit-mcp-buddy

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Reddit Buddy

Reddit Buddy MCP is a TypeScript-based MCP server that lets AI assistants browse Reddit, search posts, fetch comment threads, and analyze user profiles without requiring any Reddit API registration. It uses Reddit's public JSON API by default (10 requests/minute) and supports optional OAuth credentials to raise the limit to 60 or 100 requests per minute. The server returns clean, LLM-optimized data with no fabricated metrics, making it suitable for real-time Reddit research and sentiment analysis tasks.

Prerequisites

  • Node.js 18 or higher (for npx)
  • An MCP client such as Claude Desktop, Claude Code, or any MCP-compatible assistant
  • Optional: A Reddit account and a Reddit 'script' app for higher rate limits (reddit.com/prefs/apps)
1

Add the server to Claude Desktop configuration

Edit your Claude Desktop config file and add the reddit-mcp-buddy entry. No API keys are required for basic usage — the server works out of the box with anonymous Reddit access.

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

Add to Claude Code (optional)

If you prefer using Reddit data inside Claude Code, add the MCP server at user scope using the claude CLI.

claude mcp add --transport stdio reddit-mcp-buddy -s user -- npx -y reddit-mcp-buddy
3

Create a Reddit app for higher rate limits (optional)

Go to reddit.com/prefs/apps and click 'Create App'. Select 'script' as the app type and set the redirect URI to http://localhost:8080. Note the Client ID (shown under the app name) and Client Secret.

4

Add Reddit credentials to enable authenticated mode

Update your MCP config with all four Reddit OAuth credentials to unlock 100 requests/minute. This requires the app type to be 'script'.

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "reddit-mcp-buddy"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password"
      }
    }
  }
}
5

Restart your MCP client and test Reddit browsing

Restart Claude Desktop or your MCP client and ask it to browse a subreddit or search Reddit. The server will automatically use the highest available authentication tier.

Reddit Buddy Examples

Client configuration

Claude Desktop configuration for Reddit Buddy MCP. The anonymous mode below requires no credentials and works immediately.

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

Prompts to try

Example prompts for browsing Reddit and analyzing content via your AI assistant.

- "What's trending on Reddit right now?"
- "Search Reddit for discussions about the latest Python release"
- "Get the top 10 posts from r/programming this week"
- "Fetch the comments on this Reddit post: https://reddit.com/r/..."
- "Analyze user spez — what subreddits are they most active in?"

Troubleshooting Reddit Buddy

Rate limit errors when browsing multiple subreddits quickly

Anonymous mode is limited to 10 requests per minute. Register a Reddit script app at reddit.com/prefs/apps and add REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET to your config for 60 requests/minute, or add all four credentials for 100 requests/minute.

Authenticated mode fails with 'invalid_grant' or login errors

Ensure your Reddit app type is set to 'script' (not 'web app' or 'installed app') in reddit.com/prefs/apps. Only script apps support the password grant OAuth flow required for full authentication.

The server starts but returns empty results for some subreddits

Some subreddits require age verification or are quarantined and cannot be accessed through the public API. NSFW subreddits may return empty results in anonymous or app-only mode. Check the subreddit exists and is publicly accessible in a browser.

Frequently Asked Questions about Reddit Buddy

What is Reddit Buddy?

Reddit Buddy is a Model Context Protocol (MCP) server that enables ai assistants to browse reddit, search posts, analyze user activity, and fetch comments without requiring api keys. features smart caching, clean data responses, and optional authentication for higher rate limits. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Reddit Buddy?

Install via npm with the command: npx -y reddit-mcp-buddy. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Reddit Buddy?

Reddit Buddy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Reddit Buddy free to use?

Yes, Reddit Buddy is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Reddit Buddy?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides