Reddit MCP Server

Reddit browser for AI assistants. Browse posts, search content, analyze users. No API keys needed.

Local serverstdioPython

What is the Reddit MCP server?

Reddit browser for AI assistants. Browse posts, search content, analyze users. No API keys needed. That is what the reddit mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

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.

Getting it running

reddit-mcp-buddy on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

The tools it exposes

The server publishes 10 tools. What each one is for:

  • Feature — Reddit MCP Buddy
  • Language — TypeScript/Node.js
  • Search — ✅ Full search
  • Caching — ✅ Smart caching
  • browse_subreddit — Browse posts from any subreddit with sorting options. - Subreddit: - "all" - entire Reddit frontpage - "popular" - trending across Reddit - Any
  • search_reddit — Search across Reddit or specific subreddits. - Query: Your search terms - Filter by: subreddit, author, time, flair - Sort by: relevance, hot, top
  • get_post_details — Get a post with all its comments. - Input: - Reddit URL (supports multiple formats), OR - Post ID alone (will auto-detect subreddit, 2 API calls), OR
  • user_analysis — Analyze a Reddit user's profile. - Username: Any Reddit user - Returns: karma, posts, comments, active subreddits
  • reddit_explain — Get explanations of Reddit terms. - Terms: karma, cake day, AMA, ELI5, etc
  • Requirements — The Requirements tool exposed by this server

What it needs from you

Configuration is passed through the environment: REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD, REDDIT_BUDDY_HOST. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • Node.js >= 18.0.0 - npm or yarn - TypeScript 5.5+

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Reddit.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

This sits in the browser automation group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Reddit's toolset — Feature, Language, Search and 7 more — is a fair guide to whether it matches your workflow. It is maintained by karanb192; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
FeatureReddit MCP Buddy
LanguageTypeScript/Node.js
Search✅ Full search
Caching✅ Smart caching
browse_subredditBrowse posts from any subreddit with sorting options. - Subreddit: - "all" - entire Reddit frontpage - "popular" - trending across Reddit - Any specific subreddit (e.g., "technology", "programming", "science") - Sort by:
search_redditSearch across Reddit or specific subreddits. - Query: Your search terms - Filter by: subreddit, author, time, flair - Sort by: relevance, hot, top, new, comments
get_post_detailsGet a post with all its comments. - Input: - Reddit URL (supports multiple formats), OR - Post ID alone (will auto-detect subreddit, 2 API calls), OR - Post ID + subreddit (most efficient, 1 API call) - Supported URL for
user_analysisAnalyze a Reddit user's profile. - Username: Any Reddit user - Returns: karma, posts, comments, active subreddits
reddit_explainGet explanations of Reddit terms. - Terms: karma, cake day, AMA, ELI5, etc.
RequirementsThe Requirements tool exposed by this server.

How to install the Reddit MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js >= 18.0.0 - npm or yarn - TypeScript 5.5+
VariableDescriptionRequired
REDDIT_CLIENT_IDConfiguration value read at startup.Optional
REDDIT_CLIENT_SECRETCredential the server authenticates with.Yes
REDDIT_USERNAMEConfiguration value read at startup.Optional
REDDIT_PASSWORDConfiguration value read at startup.Optional
REDDIT_BUDDY_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • Use Reddit to Feature.
  • Use Reddit to Language.
  • Use Reddit to Search.

Frequently asked questions

It connects Reddit to MCP-compatible AI assistants such as Claude and Cursor, exposing 10 tools (Feature, Language, Search, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Reddit directly.