reddit-mcp-buddy
installs/mo · npmstarsforks
How to install reddit-mcp-buddy?
karanb192/reddit-mcp-buddy
$git clone https://github.com/karanb192/reddit-mcp-buddyA 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 - no API keys required.
README.md
| 1 | # <img src="assets/reddit-mcp-buddy-icon-white-background.png" width="48" align="center"/> Reddit MCP Buddy |
| 2 | |
| 3 | ### Reddit Browser for Claude Desktop and AI Assistants |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | [](https://registry.modelcontextprotocol.io) |
| 8 | [](https://www.npmjs.com/package/reddit-mcp-buddy) |
| 9 | [](https://www.npmjs.com/package/reddit-mcp-buddy) |
| 10 | [](https://github.com/karanb192/reddit-mcp-buddy/stargazers) |
| 11 | [](https://opensource.org/licenses/MIT) |
| 12 | |
| 13 | ## 🎬 See It In Action |
| 14 | |
| 15 |  |
| 16 | |
| 17 | *Claude checking Reddit's reaction to the Dune Part Three trailer and whether the AirPods Max 2 are worth $549* |
| 18 | |
| 19 |  |
| 20 | |
| 21 | *Claude analyzing real-time sentiment about H-1B visa changes across r/cscareerquestions and r/india* |
| 22 | |
| 23 | ## Table of Contents |
| 24 | |
| 25 | - [What makes Reddit MCP Buddy different?](#what-makes-reddit-buddy-different) |
| 26 | - [Quick Start](#quick-start-30-seconds) |
| 27 | - [What can it do?](#what-can-it-do) |
| 28 | - [Available Tools](#available-tools) |
| 29 | - [Authentication](#authentication-optional) |
| 30 | - [Installation Options](#installation-options) |
| 31 | - [Global Install](#global-install) |
| 32 | - [From Source](#from-source) |
| 33 | - [Using Docker](#using-docker) |
| 34 | - [Claude Desktop Extension](#claude-desktop-extension) |
| 35 | - [Comparison with Other Tools](#comparison-with-other-tools) |
| 36 | - [Troubleshooting](#troubleshooting) |
| 37 | - [Development](#development) |
| 38 | - [Support](#support) |
| 39 | - [Related Resources](#-related-resources) |
| 40 | |
| 41 | ## What makes Reddit MCP Buddy different? |
| 42 | |
| 43 | - **🚀 Zero setup** - Works instantly, no Reddit API registration needed |
| 44 | - **⚡ Up to 10x more requests** - Three-tier authentication system (10/60/100 requests per minute) |
| 45 | - **🎯 Clean data** - No fake "sentiment analysis" or made-up metrics |
| 46 | - **🧠 LLM-optimized** - Built specifically for AI assistants like Claude |
| 47 | - **📦 TypeScript** - Fully typed, reliable, and maintainable |
| 48 | - **✅ Proven rate limits** - Thoroughly tested authentication tiers with verification tools |
| 49 | |
| 50 | ## Quick Start (30 seconds) |
| 51 | |
| 52 | ### For Claude Desktop - Desktop Extension (Easiest!) |
| 53 | |
| 54 | 1. **Download**: [reddit-mcp-buddy.mcpb](https://github.com/karanb192/reddit-mcp-buddy/releases/latest/download/reddit-mcp-buddy.mcpb) |
| 55 | 2. **Install**: Open the downloaded file |
| 56 | 3. **Done!** Reddit tools are now available in Claude |
| 57 | |
| 58 | ### For Claude Desktop - NPM Method (Alternative) |
| 59 | |
| 60 | Add this to your `claude_desktop_config.json`: |
| 61 | |
| 62 | ```json |
| 63 | { |
| 64 | "mcpServers": { |
| 65 | "reddit": { |
| 66 | "command": "npx", |
| 67 | "args": ["-y", "reddit-mcp-buddy"] |
| 68 | } |
| 69 | } |
| 70 | } |
| 71 | ``` |
| 72 | |
| 73 | ### For Claude Code |
| 74 | |
| 75 | Run this command to add the MCP server (user scope): |
| 76 | |
| 77 | ```bash |
| 78 | claude mcp add --transport stdio reddit-mcp-buddy -s user -- npx -y reddit-mcp-buddy |
| 79 | ``` |
| 80 | |
| 81 | ### For Other MCP Clients |
| 82 | |
| 83 | Use the NPM method: `npx -y reddit-mcp-buddy` |
| 84 | |
| 85 | ## What can it do? |
| 86 | |
| 87 | Ask your AI assistant to: |
| 88 | |
| 89 | - 📊 **"What's trending on Reddit?"** - Browse hot posts from r/all |
| 90 | - 🔍 **"Search for discussions about AI"** - Search across all subreddits |
| 91 | - 💬 **"Get comments from this Reddit post"** - Fetch post with full comment threads |
| 92 | - 👤 **"Analyze user spez"** - Get user history, karma, and activity |
| 93 | - 📚 **"Explain Reddit karma"** - Understand Reddit terminology |
| 94 | |
| 95 | ## Available Tools |
| 96 | |
| 97 | ### `browse_subreddit` |
| 98 | Browse posts from any subreddit with sorting options. |
People who liked this also viewed
6 picksType
- open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)MCP ServersJul 2026
- google_workspace_mcpControl Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace / G Suite MCP Server & CLI ToolMCP ServersJul 2026
- pagerduty-mcp-serverPagerDuty's official local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account directly from your MCP-enabled client.MCP ServersJul 2026
- ms-365-mcp-serverA Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph APIMCP ServersJul 2026
- GmailManage Gmail end-to-end: send, draft, reply, forward, and bulk-modify or delete messages and threads. Organize your inbox with labels, archiving, and trashing, and retrieve messages, attachments, and profile details on demand. Access and seMCP Serversrecently
- linkedin-mcp-serverOpen-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.MCP ServersJul 2026
