# reddit-mcp-buddy

An MCP server that lets your AI assistant read Reddit: browse subreddits, search posts, pull comment threads and user profiles. No keys needed for browsing.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 865
- Author: karanb192
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/karanb192/reddit-mcp-buddy
- Updated: 2026-08-17
- HTML: https://affpapa.org/en/nevibecode/mcp/reddit-mcp-buddy

## What it does

The server connects over stdio and exposes five tools. `browse_subreddit` lists posts with hot, new, top, rising and controversial sorting, `search_reddit` searches all of Reddit or one subreddit with filters for author, time and flair, `get_post_details` returns a post with its full comment tree, `user_analysis` collects karma, posts and active subreddits, and `reddit_explain` covers terms like karma or AMA.

Without credentials, results come from Reddit's public RSS feed: `score`, `num_comments`, `upvote_ratio` and `nsfw` come back empty, and the `include_nsfw` filter cannot be applied. Search, comments, user analysis and metrics need free Reddit credentials — register an app at reddit.com/prefs/apps, pick the script type, then set `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` in the environment. Worth doing up front if you want numbers rather than headlines.

It is written in TypeScript and runs through `npx`, so nothing gets installed globally. There are three access tiers with different request limits; the project's table has the exact numbers. For `get_post_details`, pass the post ID together with the subreddit — that saves one API call.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add reddit-mcp-buddy -- npx -y reddit-mcp-buddy
```

### Codex

**Platform CLI**
```bash
codex mcp add reddit-mcp-buddy -- npx -y reddit-mcp-buddy
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "reddit-mcp-buddy": {
            "command": "npx",
            "args": [
                "-y",
                "reddit-mcp-buddy"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "reddit-mcp-buddy": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "reddit-mcp-buddy"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add reddit-mcp-buddy npx -y reddit-mcp-buddy
```

## When to use it
- check what a subreddit says about a library or a device
- pull a full comment thread instead of the first few replies
- look up a user's karma and posting history
- find discussions by keyword within a time window
- explain Reddit slang like cake day or ELI5 to the assistant

## Example prompts
- What's trending on r/programming this week?
- Search r/rust for posts from the last month and show comments on the busiest one
- Analyze user spez: karma, posts, active subreddits

## Similar
- [reddit-search-api](https://affpapa.org/en/nevibecode/skills/reddit-search-api.md) — skill · 10600 installs
- [reddit-api](https://affpapa.org/en/nevibecode/skills/alinaqi-reddit-api.md) — skill · 316 installs
- [reddit-leads](https://affpapa.org/en/nevibecode/skills/reddit-leads.md) — skill · 11900 installs
- [reddit](https://affpapa.org/en/nevibecode/skills/reddit.md) — skill · 3400 installs
- [reddit-posts](https://affpapa.org/en/nevibecode/skills/reddit-posts.md) — skill · 2300 installs
- [reddit-ads](https://affpapa.org/en/nevibecode/skills/reddit-ads.md) — skill · 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md