# reddit-mcp-server

Lets an agent read Reddit, search it, and publish posts or replies from your account. Needs Reddit OAuth credentials.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 343 repo stars
- Author: jordanburke
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jordanburke/reddit-mcp-server
- Updated: 2026-10-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/reddit-mcp-server

## What it does

The server connects an agent to Reddit over OAuth. On the reading side it returns posts, comment threads, user profiles, subreddit details and trending subreddits, and `search_reddit` queries the whole site. `browse_subreddit` pages through a feed in the sort order you pick.

Eight write tools let the agent post, reply, edit, save and delete. Deletions can't be undone. Spam protection is controlled by `REDDIT_SAFE_MODE`, which defaults to `standard` and also accepts `off` and `strict`. The footer that marks text as bot-written stays off until you set `REDDIT_BOT_DISCLOSURE=auto`.

\`REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` are mandatory, and writing also requires `REDDIT_USERNAME` and `REDDIT_PASSWORD`. Reddit stopped letting people create apps on their own in November 2025, so get your keys before you start. The server runs through `npx`. Reads are cached in memory up to 50 MB, and after an HTTP 429 response it retries up to 3 times.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `REDDIT_CLIENT_ID`, `REDDIT_CLIENT_SECRET`, `REDDIT_USERNAME`, `REDDIT_PASSWORD`, `REDDIT_AUTH_MODE`, `REDDIT_SAFE_MODE`, `REDDIT_BOT_DISCLOSURE`, `REDDIT_BOT_FOOTER` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env REDDIT_CLIENT_ID=<REDDIT_CLIENT_ID> --env REDDIT_CLIENT_SECRET=<REDDIT_CLIENT_SECRET> --env REDDIT_USERNAME=<REDDIT_USERNAME> --env REDDIT_PASSWORD=<REDDIT_PASSWORD> --env REDDIT_AUTH_MODE=<REDDIT_AUTH_MODE> --transport stdio reddit-mcp-server -- npx -y reddit-mcp-server
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add reddit-mcp-server --env REDDIT_CLIENT_ID=<REDDIT_CLIENT_ID> --env REDDIT_CLIENT_SECRET=<REDDIT_CLIENT_SECRET> --env REDDIT_USERNAME=<REDDIT_USERNAME> --env REDDIT_PASSWORD=<REDDIT_PASSWORD> --env REDDIT_AUTH_MODE=<REDDIT_AUTH_MODE> -- npx -y reddit-mcp-server
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "reddit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "reddit-mcp-server"
            ],
            "env": {
                "REDDIT_CLIENT_ID": "<REDDIT_CLIENT_ID>",
                "REDDIT_CLIENT_SECRET": "<REDDIT_CLIENT_SECRET>",
                "REDDIT_USERNAME": "<REDDIT_USERNAME>",
                "REDDIT_PASSWORD": "<REDDIT_PASSWORD>",
                "REDDIT_AUTH_MODE": "<REDDIT_AUTH_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "reddit-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "reddit-mcp-server"
            ],
            "env": {
                "REDDIT_CLIENT_ID": "<REDDIT_CLIENT_ID>",
                "REDDIT_CLIENT_SECRET": "<REDDIT_CLIENT_SECRET>",
                "REDDIT_USERNAME": "<REDDIT_USERNAME>",
                "REDDIT_PASSWORD": "<REDDIT_PASSWORD>",
                "REDDIT_AUTH_MODE": "<REDDIT_AUTH_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e REDDIT_CLIENT_ID=<REDDIT_CLIENT_ID> -e REDDIT_CLIENT_SECRET=<REDDIT_CLIENT_SECRET> -e REDDIT_USERNAME=<REDDIT_USERNAME> -e REDDIT_PASSWORD=<REDDIT_PASSWORD> -e REDDIT_AUTH_MODE=<REDDIT_AUTH_MODE> reddit-mcp-server npx -y reddit-mcp-server
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- search Reddit for threads about your library or error message
- summarize a long comment thread under a post
- check what a specific user has posted and commented
- publish a post to a subreddit without leaving the agent chat
- delete an outdated post or comment of your own

## Example prompts
- Use `search_reddit` to find threads about Vite build errors and show the most active ones
- Pull the comments for this post with `get_post_comments` and summarize what people disagree on
- Answer this comment with `reply_to_post` using the text I paste below

## Similar
- [reddit](https://affpapa.org/en/nevibecode/skills/acedatacloud-reddit.md) — skill · 212 installs
- [reddit-api](https://affpapa.org/en/nevibecode/skills/alinaqi-reddit-api.md) — skill · 322 installs
- [reddit-search-api](https://affpapa.org/en/nevibecode/skills/reddit-search-api.md) — skill · 13400 installs
- [reddit-automation](https://affpapa.org/en/nevibecode/skills/reddit-automation.md) — skill · 1500000 installs
- [reddit-marketing-agent](https://affpapa.org/en/nevibecode/skills/reddit-marketing-agent.md) — skill · 896 installs
- [Reddit Ads](https://affpapa.org/en/nevibecode/mcp/reddit-ads.md) — MCP server

---
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
