Skip to main content
reddit-mcp-buddy - AI Agents | SkillsLLM
Home AI Agents reddit-mcp-buddy Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.
AI Agentsai-assistant claude mcp mcp-server model-context-protocol
# Add to your Claude Code skills
git clone https://github.com/karanb192/reddit-mcp-buddy Reddit MCP Buddy
Reddit Browser for Claude Desktop and AI Assistants
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 - no API keys required.
🎬 See It In Action
Claude checking Reddit's reaction to the Dune Part Three trailer and whether the AirPods Max 2 are worth $549
Claude analyzing real-time sentiment about H-1B visa changes across r/cscareerquestions and r/india
Table of Contents
Sign in with GitHub to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
reddit
reddit-api
typescript
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!)
Download : reddit-mcp-buddy.mcpb
Install : Open the downloaded file
Done! Reddit tools are now available in Claude
For Claude Desktop - NPM Method (Alternative) Add this to your claude_desktop_config.json:
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "reddit-mcp-buddy"]
}
}
}
For Claude Code Run this command to add the MCP server (user scope):
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_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: 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_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 formats:
- reddit.com, www.reddit.com
- old.reddit.com, new.reddit.com
- np.reddit.com (No Participation links)
- m.reddit.com (mobile links)
- redd.it short URLs
- URLs with query params (?utm_source=...) or fragments (#comment)
- Options: comment sorting, depth, link extraction
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.
Authentication (Optional) Want more requests? Add Reddit credentials to your Claude Desktop config:
Setup Steps
Go to https://www.reddit.com/prefs/apps
Click "Create App" or "Create Another App"
Fill out the form:
Name : Any name (e.g., "reddit-mcp-buddy")
App type : Select "script" (CRITICAL for 100 rpm!)
Description : Optional
About URL : Leave blank
Redirect URI : http://localhost:8080 (required but unused)
Click "Create app"
Find your credentials:
Client ID : The string under "personal use script"
Client Secret : The secret string
Update your Claude Desktop config:
{
"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"
}
}
}
}
Three-Tier Authentication System Reddit MCP Buddy supports three authentication levels, each with different rate limits:
| Mode | Rate Limit | Required Credentials | Best For |
|------|------------|---------------------|----------|
| Anonymous | 10 req/min | None | Testing, light usage |
| App-Only | 60 req/min | Client ID + Secret | Regular browsing |
| Authenticated | 100 req/min | All 4 credentials | Heavy usage, automation |
How It Works:
Anonymous Mode : Default mode, no setup required, uses public Reddit API
App-Only Mode : Uses OAuth2 client credentials grant (works with both script and web apps)
Authenticated Mode : Uses OAuth2 password grant (requires script app type)
Script apps support BOTH app-only (60 rpm) and authenticated (100 rpm) modes
Web apps only support app-only mode (60 rpm maximum)
For 100 requests/minute, you MUST use a script app with username + password
Privacy & Data Handling Reddit MCP Buddy is designed with privacy and transparency in mind. Here's how your data is handled:
Data Collection
Reddit API Data : The server fetches public Reddit content (posts, comments, user profiles) through Reddit's official API
No Tracking : We don't collect, store, or transmit any analytics, telemetry, or usage data
No Third Parties : All data flows directly between your machine, Reddit's API, and your AI assistant
Local Storage
Authentication Credentials (optional):
Stored locally in ~/.reddit-mcp-buddy/auth.json when using --auth CLI setup
Passwords are never written to disk - only used in-memory for OAuth token exchange
Environment variables (recommended for Claude Desktop) are never persisted by this server
Cache Data :
Reddit API responses are temporarily cached in memory to improve performance
Cache size limited to 50MB maximum
All cache data is cleared when the server stops
Can be disabled with REDDIT_BUDDY_NO_CACHE=true
Data Transmission
Reddit API Only : Your credentials are only sent to Reddit's official OAuth endpoints (https://oauth.reddit.com and https://www.reddit.com)
No External Services : No data is sent to any other external services, analytics platforms, or third parties
Local Processing : All data processing happens locally on your machine
Security Notes
Read-Only Operations : All tools are read-only - the server never posts, comments, or modifies any Reddit content
Credential Safety :
OAuth tokens are stored in memory and refreshed automatically
Client secrets are treated as sensitive and never logged
Use environment variables in Claude Desktop config for maximum security
Open Source : Full source code is available at https://github.com/karanb192/reddit-mcp-buddy for security auditing
GDPR & Privacy Compliance
No Personal Data Collection : We don't collect or process any personal data beyond what's necessary to authenticate with Reddit's API
User Control : You control all credentials and can delete ~/.reddit-mcp-buddy/auth.json at any time
Right to Erasure : Simply delete the auth file or uninstall the server to remove all local data
Questions or Concerns? If you have any privacy questions or concerns, please open an issue on GitHub.
Testing & Development
Testing Your Rate Limits Reddit MCP Buddy includes comprehensive testing tools to verify your authentication is working correctly:
# Clone the repository first
git clone https:/
56,706
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
AI Agents ai-agents anthropic
An open-source AI agent that brings the power of Gemini directly into your terminal.
AI Agents ai ai-agents
An AI SKILL that provide design intelligence for building professional UI/UX multiple platforms
CLI Tools ai-skills antigravity
The agent that grows with you
AI Agents ai ai-agent
A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
AI Agents agent-skills ai-agents