A Model Context Protocol (MCP) server that lets Claude Desktop browse, search, and analyze Reddit in real time.
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.
reddit-mcp.mp4
💡 Ask Claude: "What's trending on r/programming today?"
-
Install
uvif 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"
-
Download the MCP bundle
👉 reddit-mcp.mcpb -
Double-click the
.mcpbfile — Claude Desktop installs it automatically. -
Open Claude Desktop and start asking Reddit questions.
That's it!
| 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 |
Download and install directly in Claude Desktop:
Supports: macOS • Windows • Linux
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.
Connect Reddit MCP to ChatGPT using the public SSE endpoint.
Use the pre-hosted server URL:
https://reddit-mcp-production-79ca.up.railway.app/sse
-
Run the server with SSE enabled:
SERVE_HTTPS=true uv run main.py
-
Expose it publicly:
ngrok http 8000
-
Use your ngrok URL:
https://your-subdomain.ngrok.io/sse
- Go to Settings → Apps & Connectors
- Scroll down to Advanced settings and click Create app
- Enable Developer mode (toggle ON)
- 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
- Check "I understand and want to continue"
- Click Create
Your Reddit MCP connector will appear in the enabled apps list. Start using it!
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 |
- Go to reddit.com/prefs/apps
- Click Create another app
- Select script
- Copy your Client ID and Client Secret
- Enter them when prompted during MCP setup
No tokens are stored remotely.
| 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 |
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?"
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
Contributions are welcome!
- Fork the repository
- Create a feature branch
- Commit your changes
- Open a Pull Request
Ideas: caching, sentiment analysis, topic clustering, summaries.
Licensed under the MIT License.
Reddit MCP turns Claude into a real-time Reddit analyst.