Practical overview
When it fits
Use it when Reddit research needs to happen through an MCP-compatible assistant. No-credential browsing covers subreddit posts through RSS; add Reddit credentials when the task requires search, comment retrieval, user analysis, or fuller metrics.
Who it is for
- People using Claude Desktop, Claude Code, or another MCP client who want Reddit tools inside an AI assistant.
- Researchers and analysts who need to search Reddit discussions, inspect comment threads, or review user activity.
- Developers integrating Reddit access into assistant workflows.
Documented uses
- Browse hot, new, top, rising, or controversial posts in a subreddit or across Reddit.
- Search posts across Reddit or within a subreddit, with filters such as author, time, and flair.
- Retrieve a post and its comment thread from a Reddit URL or post ID.
- Review a user's karma, posts, comments, and active subreddits.
- Look up explanations of Reddit terms such as karma, AMA, and ELI5.
Requirements & limits
The repository identifies the project as MIT-licensed. Its README documents a Claude Desktop extension and npm-based setup for Claude Desktop and other MCP clients.
- Anonymous browsing uses Reddit’s public RSS feed; scores, comment counts, upvote ratios, and NSFW values are null, and the NSFW filter cannot be applied.
- Reddit credentials unlock search, comments, user analysis, and fuller metrics; the README describes anonymous, app-only, and authenticated modes with different request limits.
- Reddit’s per-IP RSS throttling can make sustained anonymous browsing slower than the server-side request cap.
- The server works through an MCP client, so the intended workflow is to ask an assistant to use its Reddit tools.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Add Reddit MCP Buddy to Claude Desktop with npm
Configure Claude Desktop to launch Reddit MCP Buddy as an MCP server.
Before you start
- Claude Desktop
- The documented npm-based setup
Steps
Open the Claude Desktop configuration file, claude_desktop_config.json.
Add an mcpServers entry named reddit with command npx and arguments -y and reddit-mcp-buddy.
Save the configuration so Claude Desktop can use the Reddit server.
Expected outcome
Reddit MCP Buddy is configured as an MCP server for Claude Desktop, with subreddit browsing available without Reddit credentials.
Guide limitations
- Search, comment retrieval, user analysis, and fuller metrics require Reddit credentials.
- Without credentials, browsing uses Reddit’s public RSS feed; engagement metrics are null and the NSFW filter cannot be applied.
Configure Reddit credentials for Claude Desktop
Add Reddit app credentials to the Claude Desktop server configuration for credential-dependent Reddit tools.
Before you start
- Claude Desktop
- A Reddit app created at https://www.reddit.com/prefs/apps
- Reddit client ID and client secret
- Reddit username and password for authenticated mode
Steps
Create a Reddit app and select the documented script app type.
Copy its client ID and client secret.
Add the credentials as REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, and REDDIT_PASSWORD environment variables in the Reddit MCP Buddy entry in claude_desktop_config.json.
Expected outcome
The server configuration includes Reddit credentials for authenticated use of search, comments, user analysis, and fuller metrics.
Guide limitations
- The documentation says browsing can work without credentials, but these additional tools require them.
- Interactive authentication is documented for local testing and does not work with Claude Desktop.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 12 October 2026
- Original website title
- karanb192/reddit-mcp-buddy · Official homepage title · retained in its source language