A Model Context Protocol (MCP) server designed to provide AI assistants, particularly Claude Desktop, with direct access to Reddit data. It enables browsing posts, searching content, and analyzing user activity without requiring users to register for Reddit API keys, offering a clean, LLM-optimized data stream for AI-driven insights.

How It Works

This project implements an MCP server using TypeScript and Node.js, acting as a bridge to the Reddit API. It employs a three-tier authentication system to manage request rates, offering up to 100 requests per minute with full authentication. The server prioritizes delivering clean, raw Reddit data optimized for AI consumption, avoiding fabricated metrics or unnecessary fields. It includes intelligent, memory-safe caching (50MB limit) to enhance performance and reduce API load.

Quick Start & Requirements

• Primary Install: For Claude Desktop, download the reddit-mcp-buddy.mcpb extension file and open it. Alternatively, use npx -y reddit-mcp-buddy for other MCP clients or configure claude_desktop_config.json.
• Prerequisites: Node.js (>= 18.0.0) and npm/yarn are required. Reddit API credentials (Client ID, Client Secret, Username, Password) are optional but necessary for achieving the highest rate limits (60-100 req/min).
• Links: GitHub Repository: https://github.com/karanb192/reddit-mcp-buddy

Highlighted Details

• Zero setup required for basic functionality; no Reddit API registration needed.
• Achieve up to 100 requests per minute through a tiered authentication system.
• Provides clean, LLM-optimized data, focusing solely on official Reddit API content.
• Includes built-in tools for testing and verifying authentication and rate limits.
• Offers tools for browsing subreddits, searching content, fetching post details with comments, and analyzing user profiles.

Maintenance & Community

The project emphasizes a community-driven approach with "No venture capital, no tracking." Primary support and development interaction occur through the GitHub repository.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The MIT license permits unrestricted use, modification, and distribution, making it compatible with commercial and closed-source applications.

Limitations & Caveats

The Desktop Extension format is noted as being in preview as of September 2025. Achieving the highest rate limits (100 req/min) necessitates creating a Reddit "script" type application and providing full authentication credentials.