Skip to content

README.md

Latest commit

 

History

History
247 lines (172 loc) · 6.07 KB

README.md

File metadata and controls

247 lines (172 loc) · 6.07 KB

Reddit MCP Logo

Reddit MCP

A Model Context Protocol (MCP) server that lets Claude Desktop browse, search, and analyze Reddit in real time.

MIT License Python 3.12+ Claude MCP

✨ What is Reddit MCP?

Reddit MCP is a plug-and-play MCP server that allows Claude Desktop to interact directly with Reddit.

Your AI can:

  • Explore subreddits
  • Search discussions and opinions
  • Fetch full comment threads
  • Analyze Reddit users
  • Detect trends and sentiment in real time

No scraping. No setup friction. Works instantly.

🎬 Quick Demo

reddit-mcp.mp4

💡 Ask Claude: "What's trending on r/programming today?"

🚀 Quick Start (30 seconds)

  1. Install uv if you don't have it:

    macOS / Linux

    curl -LsSf https://astral.sh/uv/install.sh | sh
sudo ln -sf ~/.local/bin/uv /usr/local/bin/uv

    Windows

    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

  2. Download the MCP bundle
    👉 reddit-mcp.mcpb

  3. Double-click the .mcpb file — Claude Desktop installs it automatically.

  4. Open Claude Desktop and start asking Reddit questions.

That's it!

🔥 Key Features

Feature Description
🔍 Browse Subreddits View posts from any subreddit with hot, new, top, or rising sorting
🔎 Search Reddit Search globally or within specific communities
📄 Post Details Fetch full post content with deeply threaded comments
👤 User Analysis Analyze a Reddit user's karma, activity patterns, and top subreddits
🔓 Anonymous Mode No API keys required. Works out of the box
⚡ Optional OAuth Add Reddit credentials for higher rate limits and stability

📦 One-Click Installation (Recommended)

Download and install directly in Claude Desktop:

Download

Supports: macOS • Windows • Linux

🛠️ Manual Installation

Add the server to claude_desktop_config.json:

{
  "mcpServers": {
    "reddit-mcp": {
      "command": "/usr/local/bin/uv",
      "args": ["run", "main.py"],
      "cwd": "/path/to/reddit-mcp"
    }
  }
}

Restart Claude Desktop after saving.

🤖 ChatGPT Integration

Connect Reddit MCP to ChatGPT using the public SSE endpoint.

Use Hosted Server (Recommended)

Use the pre-hosted server URL:

https://reddit-mcp-production-79ca.up.railway.app/sse

Or Self-Host with ngrok

  1. Run the server with SSE enabled:

    SERVE_HTTPS=true uv run main.py

  2. Expose it publicly:

    ngrok http 8000

  3. Use your ngrok URL: https://your-subdomain.ngrok.io/sse

Setup in ChatGPT

  1. Go to Settings → Apps & Connectors
  2. Scroll down to Advanced settings and click Create app
  3. Enable Developer mode (toggle ON)
  4. Click Create App and fill in:
    • Icon: Upload the Reddit MCP logo (optional)
    • Name: Reddit MCP
    • Description: Browse, search, and analyze Reddit
    • MCP Server URL: https://reddit-mcp-production-79ca.up.railway.app/sse
    • Authentication: Select No Auth
  5. Check "I understand and want to continue"
  6. Click Create

Your Reddit MCP connector will appear in the enabled apps list. Start using it!

🔐 Authentication (Optional)

Anonymous access works, but OAuth unlocks higher limits.

Mode Rate Limit Setup Required
Anonymous ~10 req/min None
OAuth ~60 req/min Client ID + Secret

How to enable OAuth

  1. Go to reddit.com/prefs/apps
  2. Click Create another app
  3. Select script
  4. Copy your Client ID and Client Secret
  5. Enter them when prompted during MCP setup

No tokens are stored remotely.

🧰 Available MCP Tools

Tool Description
browse_subreddit Browse posts from any subreddit
search_reddit Search Reddit posts by keyword
get_post_details Fetch full post content and comments
user_analysis Analyze Reddit user activity and karma

💬 Example Queries

Trending & Discovery

  • "What's trending across all of Reddit today?"
  • "Show me the hottest discussions in r/technology"

Search & Opinions

  • "What are people saying about GPT-4?"
  • "Find discussions about remote work in r/cscareerquestions"

Post & Comment Analysis

  • "Get the full discussion from this Reddit post"
  • "Summarize the top comments on post abc123"

User Analysis

  • "Analyze the Reddit user spez"
  • "What subreddits does u/DeepFuckingValue post in?"

📁 Project Structure

reddit-mcp/
├── main.py           # MCP server entry point
├── reddit/
│   └── api.py        # Reddit API client (OAuth + anonymous)
├── manifest.json     # MCP bundle metadata
├── pyproject.toml    # Python dependencies
└── README.md

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Open a Pull Request

Ideas: caching, sentiment analysis, topic clustering, summaries.

📄 License

Licensed under the MIT License.

Reddit MCP turns Claude into a real-time Reddit analyst.