/ Directory / Playground / reddit-mcp-buddy
← All servers ↗ GitHub
● Community karanb192 ⚡ Instant

reddit-mcp-buddy

by karanb192 · karanb192/reddit-mcp-buddy

Clean, LLM-optimized Reddit MCP server — browse subreddits, search posts, get full threads, and analyze users. Zero setup.

reddit-mcp-buddy is a TypeScript MCP server that gives AI assistants clean, fast access to Reddit data. It provides 5 tools for browsing subreddits, searching posts, reading full threads with comments, analyzing user profiles, and explaining Reddit terminology. Works with zero setup via npx, supports three-tier authentication (10/60/100 req/min), and includes smart caching with 50MB memory limits.

▶ Watch demo 📦 Install 💡 Use Cases

Why use it

Key features

Live Demo

What it looks like in practice

reddit-mcp-buddy-2.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "reddit-mcp-buddy-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/karanb192/reddit-mcp-buddy"
      ]
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "reddit-mcp-buddy-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/karanb192/reddit-mcp-buddy"
      ]
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "reddit-mcp-buddy-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/karanb192/reddit-mcp-buddy"
      ]
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "reddit-mcp-buddy-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/karanb192/reddit-mcp-buddy"
      ]
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "reddit-mcp-buddy-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/karanb192/reddit-mcp-buddy"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "reddit-mcp-buddy-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/karanb192/reddit-mcp-buddy"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add reddit-mcp-buddy-2 -- TODO 'See README: https://github.com/karanb192/reddit-mcp-buddy'

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use reddit-mcp-buddy

Analyze a Reddit user's posting patterns and interests

👤 Community moderators and researchers ⏱ ~5 min beginner

When to use: You want to understand a user's activity, interests, and engagement patterns.

Flow
  1. Run user analysis
    Analyze the Reddit user 'spez'. Show their karma breakdown, most active subreddits, and posting frequency.✓ Copied
    → User profile with activity analysis

Outcome: Comprehensive understanding of a user's Reddit presence.

Pitfalls
  • Private or deleted accounts return empty data — Verify the username is correct and the account is public

Combinations

Pair with other MCPs for X10 leverage

reddit-mcp-buddy-2 + filesystem

Save Reddit research to files for analysis

Search r/startups for posts about 'AI SaaS pricing' and save the top 10 results with comments to ~/research/reddit-pricing.md.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
browse_subreddit subreddit: str, sort?: str, limit?: int Browse posts from a subreddit with sorting options 1 Reddit API call
search_reddit query: str, subreddit?: str, sort?: str Search across Reddit or within a specific subreddit 1 Reddit API call
get_post_details url_or_id: str Get full post with comment thread 1 Reddit API call
user_analysis username: str Analyze a Reddit user's profile and activity 1 Reddit API call
reddit_explain term: str Explain Reddit terminology (karma, cake day, AMA, etc.) 0

Cost & Limits

What this costs to run

API quota
Anonymous: 10 req/min. Script auth: 60/min. OAuth: 100/min.
Tokens per call
300–2000 tokens per tool call (comment threads can be large)
Monetary
Free — Reddit API is free for personal/non-commercial use
Tip
Use browse_subreddit for overviews before get_post_details to avoid fetching large threads you don't need.

Security

Permissions, secrets, blast radius

Credential storage: Optional Reddit API credentials in environment variables for higher rate limits
Data egress: All calls to Reddit API (oauth.reddit.com / www.reddit.com)

Troubleshooting

Common errors and fixes

Rate limit exceeded (429)

You're on the anonymous tier (10 req/min). Add Reddit API credentials for higher limits.

Verify: Check your auth tier in the server startup output
Post not found

The URL format may not be recognized. Try using the post ID directly, or the full Reddit URL.

Verify: Try browse_subreddit first to find the post
Empty search results

Reddit search can be finicky. Try broader terms or search within a specific subreddit.

Verify: Try the same search on reddit.com to verify results exist

Alternatives

reddit-mcp-buddy vs others

AlternativeWhen to use it insteadTradeoff
claude-skill-redditYou need to post and comment on Reddit, not just readCan write to Reddit but macOS-only and uses browser automation

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills