Reddit MCP Buddy MCP Server

How to use

Use an MCP client to connect to the Reddit MCP Buddy server and access tools for browsing subreddits, searching posts, and retrieving post details with comments. You can ask your AI assistant to discover trending discussions, search across Reddit, fetch full post threads, analyze a user’s activity, or explain Reddit terms. The server runs locally or via your MCP client configuration and returns structured, relevant data designed for easy consumption by the AI.

How to install

Prerequisites: Node.js (version 18 or newer) and npm (or yarn). Ensure these are available in your environment before proceeding.

Quick Start (practical options)

For Claude Desktop — Desktop Extension (easiest) Enable Reddit tools quickly.

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

For Claude Code

Add the MCP server to your Claude code configuration using the user scope.

claude mcp add --transport stdio reddit-mcp-buddy -s user -- npx -y reddit-mcp-buddy

For Other MCP Clients

Use the same NPM method to connect. Run the MCP client with the provided command.

npx -y reddit-mcp-buddy

For Claude Desktop Extension build from source

If you prefer the extension, you can build it from source.

git clone https://github.com/karanb192/reddit-mcp-buddy.git
cd reddit-mcp-buddy
./scripts/build-mcpb.sh

From source

If you want to install the MCP server locally from source, follow these steps.

git clone https://github.com/karanb192/reddit-mcp-buddy.git
cd reddit-mcp-buddy
npm install
npm run build
npm link

Using Docker

Run the server in a container for isolation.

docker run -it karanb192/reddit-mcp-buddy

Claude Desktop Extension details

For one-click installation in Claude Desktop, download the pre-built extension and open the file to install.

📦 Download reddit-mcp-buddy.mcpb

Security and credentials (optional)

You can enable higher rate limits by providing Reddit credentials in the Claude Desktop configuration. Credentials are optional and are stored locally only when you choose to configure them.

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "reddit-mcp-buddy"],
      "env": {
        "REDDIT_CLIENT_ID": "YOUR_CLIENT_ID",
        "REDDIT_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "REDDIT_USERNAME": "YOUR_USERNAME",
        "REDDIT_PASSWORD": "YOUR_PASSWORD"
      }
    }
  }
}

Authentication and rate limits

Reddit MCP Buddy supports three authentication levels, each with different rate limits. Anonymous grants 10 requests per minute, app-only grants 60 per minute, and authenticated grants 100 per minute. Script apps can leverage both app-only and authenticated modes, while web apps typically support app-only mode.

Privacy, data handling, and open source

Data is fetched from Reddit’s official API. No third-party analytics are used, and data is processed locally on your machine. Tokens and credentials are kept in memory or local storage as described, and you can delete local data at any time.

Testing and development

You can verify rate limits and authentication behavior with dedicated tests. Mirror the steps in your environment to confirm anonymous, app-only, and authenticated modes behave as expected.

Notes

The server includes built-in caching to improve performance and reduce Reddit API calls. Cache is kept in memory with a configurable limit and is cleared when the server stops.

browse_subreddit

Browse posts from a subreddit with sorting options and optional metadata about the subreddit.

search_reddit

Search across Reddit or specific subreddits with filters and sorting options.

get_post_details

Fetch a post with its comments, supporting multiple Reddit URL formats.

user_analysis

Analyze a Reddit user’s profile including karma, posts, and activity.

reddit_explain

Explain common Reddit terms and concepts for clarity.