reddit-mcp-buddy
Reddit MCP Buddy is a TypeScript-based Model Context Protocol server that allows Claude Desktop and other AI assistants to browse Reddit, search posts, and analyze user activity without requiring Reddit API registration. It offers three authentication tiers (10, 60, or 100 requests per minute) and provides clean, LLM-optimized data for AI analysis.
Key facts
Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.
| Field | Value |
|---|---|
| Repository | karanb192/reddit-mcp-buddy |
| Owner | karanb192 |
| Primary language | TypeScript |
| License | MIT — OSI-approved |
| Stars | 748 |
| Forks | 95 |
| Open issues | 9 |
| Latest release | v1.1.13 (2026-05-26) |
| Last updated | 2026-07-07 |
| Source | https://github.com/karanb192/reddit-mcp-buddy |
What reddit-mcp-buddy is
A TypeScript MCP server implementing read-only Reddit API integration via OAuth2 (anonymous, app-only, and authenticated modes). It exposes five tools: browse_subreddit, search_reddit, get_post_details, user_analysis, and reddit_explain. Uses in-memory caching (50MB limit) and supports multiple URL formats for Reddit link parsing.
Get the reddit-mcp-buddy source
Clone the repository and explore it locally.
git clone https://github.com/karanb192/reddit-mcp-buddy.gitcd reddit-mcp-buddy# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
Implementation considerations
- Decide on authentication tier (anonymous 10 rpm, app-only 60 rpm, or authenticated 100 rpm) and configure environment variables (REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD) accordingly; script-type apps required for 100 rpm mode.
- Credentials can be stored locally in ~/.reddit-mcp-buddy/auth.json or via environment variables; passwords are never persisted to disk, only used in-memory for OAuth token exchange.
- In-memory cache can be disabled via REDDIT_BUDDY_NO_CACHE=true if data freshness is critical; otherwise, consider cache hits will reduce API calls and improve performance.
- All five tools (browse_subreddit, search_reddit, get_post_details, user_analysis, reddit_explain) are read-only and will not modify Reddit state; plan rate-limiting strategy if scaling to high-concurrency usage.
- Deployment via npx, npm global install, Docker, or Claude Desktop extension (.mcpb); pick the method matching your infrastructure and automation setup.
When to avoid it — and what to weigh
- Requiring Write Access to Reddit — This server is read-only. If you need to post, comment, or moderate Reddit content programmatically, this tool cannot help.
- High-Volume, Real-Time Streaming Requirements — Rate limits cap at 100 requests/minute (authenticated). For continuous live monitoring or high-frequency polling, this will hit limits quickly.
- Private or Restricted Subreddit Access — The server can only access public Reddit data. Private communities or restricted access patterns require separate OAuth flows not implemented here.
- Need for Data Persistence and Historical Analytics — Caching is limited to 50MB in-memory and cleared on shutdown. No built-in database or long-term data warehousing; you must externally persist any data you want to retain.
License & commercial use
MIT License. Permissive; allows use, modification, and distribution in commercial and private contexts with no restrictions beyond attribution. No warranty implied.
MIT is a permissive OSI license allowing commercial use. However, Reddit's API Terms of Service prohibit certain scraping and commercial use patterns. While the tool itself is open-source and MIT-licensed, using it to build commercial services that scrape Reddit data requires review of Reddit's developer agreement and compliance with their usage policies. Assess Reddit's current terms before deploying to production revenue-generating applications.
DEV.co evaluation signals
Editorial assessment — not user reviews. Directional, with an explicit confidence level.
| Signal | Assessment |
|---|---|
| Maintenance | Active |
| Documentation | Strong |
| License clarity | Clear |
| Deployment complexity | Low |
| DEV.co fit | Good |
| Assessment confidence | High |
Read-only operations prevent data modification. OAuth2 used for Reddit authentication; client secrets and passwords are not persisted to disk (only in-memory during token exchange). Credentials can be passed via environment variables (preferred for Claude Desktop) or local auth file. No external telemetry or third-party data transmission. Reddit's API endpoint is the only external communication. Recommend: (1) Use app-type script for authenticated tier if needed, (2) store credentials in environment variables in Claude Desktop config rather than disk files, (3) review Reddit API Terms of Service for commercial use constraints.
Alternatives to consider
PRAW (Python Reddit API Wrapper)
Full-featured Python library with read and write access to Reddit. Requires more setup and OAuth credentials, but offers complete Reddit API coverage for custom tooling.
Pushshift (Archive Queries)
Historical Reddit data queries; complementary if you need to analyze past posts and comments. Does not integrate with Claude or MCP natively.
Manual Claude Prompt + Browser Extension
No-code alternative: ask Claude to summarize Reddit links you paste. Lower automation, higher latency, but requires no tools or rate limits.
Build on reddit-mcp-buddy with DEV.co software developers
Install Reddit MCP Buddy in 30 seconds via .mcpb extension or NPM. Start asking Claude about Reddit trends, sentiment, and communities today.
Talk to DEV.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
reddit-mcp-buddy FAQ
Do I need a Reddit account to use Reddit MCP Buddy?
How much does it cost?
Can I post or comment on Reddit with this?
What happens if I hit the rate limit?
Software development & web development with DEV.co
DEV.co is a software development agency delivering custom software development services to companies building on open source. Our software developers and web developers design, integrate, and ship production systems — spanning web development, APIs, AI, data, and cloud. If reddit-mcp-buddy is part of your mcp servers roadmap, our team can implement, customize, migrate, and maintain it.
Ready to Add Reddit to Claude?
Install Reddit MCP Buddy in 30 seconds via .mcpb extension or NPM. Start asking Claude about Reddit trends, sentiment, and communities today.