PlugWiki
Reddit MCP Buddy logo

Reddit MCP Buddy: Browse and Search Reddit from Claude and Cursor

CommunityLocal
Getnpmreddit-mcp-buddykaranb192/reddit-mcp-buddy
Tools
8
6 read · 2 change
Stars
868
on GitHub
Downloads
1.8K
a week
Works in
12
apps
Risk
Medium
read only

Lets Claude and Cursor browse subreddits, read comment threads and look up Reddit users.

This is a community server by karanb192, not made by Reddit. Browsing subreddits works with no account, using Reddit's public RSS feeds. Search, comments and user lookups need Reddit API credentials, and Reddit requires approval before it gives them out. Posting and commenting are off unless you switch them on, and they then act as your Reddit account.

Good for

  • Researchers checking what people say about a product or topic
  • Marketers and founders tracking subreddit discussions
  • Community managers who draft posts with the sub's rules in view

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install Reddit MCP Buddy

Claude Code

  1. 1

    Copy this prompt.

    Add the Reddit MCP Buddy server to Claude Code. Run this command:

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

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Built from the package data we hold. Not yet tested by us.

Tools

  • Shows posts from any subreddit

    Lists posts from a subreddit or from r/all or r/popular, sorted hot, new, top, rising or controversial. Without Reddit credentials it reads Reddit's public RSS feed, so scores, comment counts and NSFW flags come back empty.

    Try: “What's hot on r/programming right now?”

    Network · browse_subreddit

  • Searches posts across Reddit

    Finds posts matching your search terms across Reddit or in chosen subreddits, with filters for author, time and flair. Needs approved Reddit API credentials.

    Try: “Search Reddit for discussions about local LLMs from the past month.”

    Network · search_reddit

  • Opens a post with its comments

    Fetches one post and its comment thread from a Reddit link or post ID. It accepts old.reddit, np.reddit, mobile and redd.it links. Needs approved Reddit API credentials.

    Try: “Summarize the comments on this Reddit thread: <link>”

    Network · get_post_details

  • Summarizes a Reddit user's activity

    Returns a user's recent posts, comments, karma and the subreddits they are active in. Needs approved Reddit API credentials.

    Try: “What does the user spez usually post about?”

    Network · user_analysis

  • Explains Reddit terms and slang

    Returns a definition, origin and examples for Reddit terms such as karma, cake day or AMA. The README says it works offline.

    Try: “Explain what ELI5 means on Reddit.”

    Read · reddit_explain

  • Reads a subreddit's rules and flairs (opt-in)

    Fetches a subreddit's rules, posting requirements and flair choices so a draft fits before it is submitted. It only appears when posting is enabled.

    Try: “What are the posting rules and required flair on r/test?”

    Network · subreddit_rules

  • Posts to a subreddit as you (opt-in)

    Submits a text or link post to one subreddit from your Reddit account, after checking the subreddit's rules. A dry-run option posts nothing. It only appears when posting is enabled.

    Try: “Draft a post for r/test and check it against the rules, but do not submit yet.”

    Write · create_post

  • Comments or replies as you (opt-in)

    Comments on a post or replies to a comment from your Reddit account. It only appears when posting is enabled.

    Try: “Reply to that comment thanking them for the link.”

    Write · add_comment

Read from the source code

Permissions

medium risk · 4 things to watch

Medium risk

By default the server only reads public Reddit content. If you turn on posting, the assistant can publish posts and comments as your Reddit account, so enable it only in a client that asks you before each submit.

What it can do

Watch out for

  • Opt-in posting acts as your Reddit account

    With REDDIT_BUDDY_WRITE on, create_post and add_comment publish under your name. Where the client supports confirmation prompts it asks you first, otherwise approval depends on the client and the model. github.com

  • A Reddit password gives full account access

    The README says the password sign-in returns a token with full account scope. Prefer the refresh-token route, which carries only the scopes you approve. github.com

  • It reads other people's public Reddit content

    Posts, comments and user histories are passed to your assistant as text. Treat them as untrusted, since anyone can write a post that tries to give the model instructions. github.com

  • Posting has hourly limits

    The server caps posting at 5 posts and 30 comments an hour, with 15 seconds between writes. The README says a restart resets the caps. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyRead-only is the default. The three posting tools only exist when REDDIT_BUDDY_WRITE is set, and they refuse to load over the HTTP mode.
Talks toreddit.com and oauth.reddit.com
Sign-in and keysCredentials come from environment variables. The README says the optional --auth setup stores them in ~/.reddit-mcp-buddy/auth.json and never writes passwords to disk.
Scopes

  • Reddit app client ID and secret (optional)

  • Reddit username and password or a refresh token (optional)

Questions

Is Reddit MCP Buddy official?

No. It is a community project by karanb192 and is not made by Reddit.

Does it need a Reddit API key?

Not for browsing a subreddit, which uses Reddit's public RSS feed. Search, post comments and user analysis need credentials for a Reddit app, and Reddit says its API needs approval first.

Can it post or comment on Reddit?

Only if you turn it on. Set REDDIT_BUDDY_WRITE to true with credentials that allow posting. It is off by default and does not load over the HTTP mode.

Is it free?

Yes. It is MIT licensed and free to run, though you need Reddit's approval for API access.

What is the easiest way to add it to Claude Desktop?

The README offers a one-click .mcpb file on its GitHub releases page, or you can use the npx config in the install box.

Which clients does it work in?

Clients that start a local program, such as Claude Desktop, Claude Code and Cursor. It runs locally, so ChatGPT and n8n cannot connect.

Why do search and comments return nothing without keys?

Reddit blocks the logged-out API. Without credentials only browsing (through RSS) and the term explainer work.

Does using it fit Reddit's rules?

Only with Reddit's approval for API use. The README says Reddit's Responsible Builder Policy requires explicit approval before an app uses the API, and that the project cannot grant it or supply shared keys. Browsing through the public RSS feeds needs no keys, but the README notes RSS can be blocked or throttled. Check Reddit's current terms for your use case, especially before automating posts.

Information

updated Nov 2, 2026

Publisher
Community
Package
reddit-mcp-buddy
Registry
npm
Transport
stdio
Auth
None
Version
1.1.14
License
MIT
Last commit
Oct 30, 2026
Listed in
Official MCP registry

GitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. github.com · github.com
  2. github.com · github.com
  3. www.npmjs.com · npmjs.com
  4. support.reddithelp.com · support.reddithelp.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.