reddit-mcp-buddy

# <img src="assets/reddit-mcp-buddy-icon-white-background.png" width="48" align="center"/> Reddit MCP Buddy ### Reddit Browser for Claude Desktop and AI Assistants A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that enables Claude Desktop and other AI assistants to browse Reddit, search posts, and analyze user activity. Clean, fast, and actually works - no API keys required. [](https://registry.modelcontextprotocol.io/v0/servers/5677b351-373d-4137-bc58-28f1ba0d105d) [](https://www.npmjs.com/package/reddit-mcp-buddy) [](https://www.npmjs.com/package/reddit-mcp-buddy) [](https://github.com/karanb192/reddit-mcp-buddy/stargazers) [](https://opensource.org/licenses/MIT) ## 🎬 See It In Action  *Claude analyzing real-time sentiment about H-1B visa changes across r/cscareerquestions and r/india* ## Table of Contents - [What makes Reddit MCP Buddy different?](#what-makes-reddit-buddy-different) - [Quick Start](#quick-start-30-seconds) - [What can it do?](#what-can-it-do) - [Available Tools](#available-tools) - [Authentication](#authentication-optional) - [Installation Options](#installation-options) - [Global Install](#global-install) - [From Source](#from-source) - [Using Docker](#using-docker) - [Claude Desktop Extension](#claude-desktop-extension) - [Comparison with Other Tools](#comparison-with-other-tools) - [Troubleshooting](#troubleshooting) - [Development](#development) - [Support](#support) - [Related Resources](#-related-resources) ## What makes Reddit MCP Buddy different? - **🚀 Zero setup** - Works instantly, no Reddit API registration needed - **⚡ Up to 10x more requests** - Three-tier authentication system (10/60/100 requests per minute) - **🎯 Clean data** - No fake "sentiment analysis" or made-up metrics - **🧠 LLM-optimized** - Built specifically for AI assistants like Claude - **📦 TypeScript** - Fully typed, reliable, and maintainable - **✅ Proven rate limits** - Thoroughly tested authentication tiers with verification tools ## Quick Start (30 seconds) ### For Claude Desktop - Desktop Extension (Easiest!) 1. **Download**: [reddit-mcp-buddy.mcpb](https://github.com/karanb192/reddit-mcp-buddy/releases/latest/download/reddit-mcp-buddy.mcpb) 2. **Install**: Open the downloaded file 3. **Done!** Reddit tools are now available in Claude ### For Claude Desktop - NPM Method (Alternative) Add this to your `claude_desktop_config.json`: ```json { "mcpServers": { "reddit": { "command": "npx", "args": ["-y", "reddit-mcp-buddy"] } } } ``` ### For Claude Code Run this command to add the MCP server (user scope): ```bash claude mcp add --transport stdio reddit-mcp-buddy -s user -- npx -y reddit-mcp-buddy ``` ### For Other MCP Clients Use the NPM method: `npx -y reddit-mcp-buddy` ## What can it do? Ask your AI assistant to: - 📊 **"What's trending on Reddit?"** - Browse hot posts from r/all - 🔍 **"Search for discussions about AI"** - Search across all subreddits - 💬 **"Get comments from this Reddit post"** - Fetch post with full comment threads - 👤 **"Analyze user spez"** - Get user history, karma, and activity - 📚 **"Explain Reddit karma"** - Understand Reddit terminology ## Available Tools ### `browse_subreddit` Browse 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: hot, new, top, rising, controversial - Time range: hour, day, week, month, year, all (for top/controversial sort) - Include subreddit info: Optional flag for subreddit metadata ``` ### `search_reddit` Search across Reddit or specific subreddits. ``` - Query: Your search terms - Filter by: subreddit, author, time, flair - Sort by: relevance, hot, top, new, comments ``` ### `get_post_details` Get a post with all its comments. ``` - Input: - Reddit URL (full URL including subreddit), OR - Post ID alone (will auto-detect subreddit, 2 API calls), OR - Post ID + subreddit (most efficient, 1 API call) - Options: comment sorting, depth, link extraction ``` ### `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. ```