Reddit MCP Buddy

A Model Context Protocol (MCP) server that enables Claude Desktop and other AI assistants to browse Reddit, search posts, and analyze user activity. Clean, fast, and actually works - browse subreddits with no API keys; add free Reddit credentials for search, comments, user analysis, and full metrics. Its 10 documented tools cluster into read & search, options, username, returns.

People connecting social media tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-17 · ★ 801 · #1 OF 46 MAINTAINED SOCIAL MEDIA · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Reddit MCP Buddy

before you install - you'll need

Set REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD, REDDIT_BUDDY_PORT before connecting.

Claude Code

claude mcp add karanb192-reddit-mcp-buddy -- npx -y reddit-mcp-buddy

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "karanb192-reddit-mcp-buddy": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-mcp-buddy"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package reddit-mcp-buddy - unscoped; check the name against the project README before installing

registry namespace io.github.karanb192 is GitHub-verified and matches the repo owner

03 · What Reddit MCP Buddy can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can browse posts from any subreddit with sorting options, search across Reddit or specific subreddits, get a post with all its comments, and analyze a Reddit user's profile.

Capability map

Tools grouped from the project's README - what Reddit MCP Buddy lets an agent do.

read & search

3 tools - e.g. Your search terms; Search across Reddit or specific subreddits.; Get a post with all its comments.

Query · search_reddit · get_post_details

Options

1 tool - e.g. comment sorting, depth, link extraction

Options

Username

1 tool - e.g. Any Reddit user

Username

Returns

1 tool - e.g. karma, posts, comments, active subreddits

Returns

Terms

1 tool - e.g. karma, cake day, AMA, ELI5, etc.

Terms

Browse

1 tool - e.g. Browse posts from any subreddit with sorting options.

browse_subreddit

User

1 tool - e.g. Analyze a Reddit user's profile.

user_analysis

1 tool - e.g. Get explanations of Reddit terms.

reddit_explain

Latest releases

v1.1.14 · 2026-07-29

correct OIDC audience for MCP registry login · skip npm publish if version already exists · add SECURITY.md and enable private vulnerability reporting · author line with site + blog link · add RSS fallback for…

v1.1.13 · 2026-05-26

get_post_details now works for subreddits with underscores · Subreddits like \r/AI_Agents\, \r/web_design\, \r/game_development\ were returning \"r/AI does not exist"\ due to \.split('_')\ splitting on every underscore…

v1.1.12 · 2026-02-21

Major reliability, security, and testing release with 2,800+ lines of improvements across 20+ files. · What's New Since v1.1.10 · Test Suite (NEW) · 39 unit tests (~5s) covering build, CLI, auth, cache, rate limiter…

04 · Who maintains Reddit MCP Buddy

reddit-mcp-buddy is maintained by karanb192. It's the only MCP server we track from this author; the repo dates to Sep 2025.

05 · Facts

repository: github.com/karanb192/reddit-mcp-buddy
category: social media - ranked #1 of 46 actively-maintained social media servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-07-29)
registry: io.github.karanb192/reddit-mcp-buddy (active, first published 2025-09-17 · 7 versions)
packages: npm:reddit-mcp-buddy

06 · Reddit MCP Buddy FAQ

Is Reddit MCP Buddy still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-17 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Reddit MCP Buddy do?

How do I install Reddit MCP Buddy?

Run `npx -y reddit-mcp-buddy`. The README documents 5 environment variables (REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME…) to set first. Set REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD, REDDIT_BUDDY_PORT before connecting. You can also paste the ready-made client config above.

Does Reddit MCP Buddy run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Reddit MCP Buddy

Alternatives to Reddit MCP Buddy

Maintained social media servers if Reddit MCP Buddy isn't the fit.

More social media MCP servers · Unlinked · Letmepost · Excalibur MCP · Backstory: search your data exports locally

More TypeScript MCP servers · My Cool Proxy · Thoughtbox · Kastell · Ats · Anybrowse · see all