reddit-mcp
Fetches Reddit content including posts, comments, subreddit listings, and user pages via Reddit's public JSON API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@reddit-mcpshow top posts from r/worldnews"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
reddit-mcp
A Model Context Protocol (MCP) server that lets LLMs fetch and read content from Reddit. Give Claude the ability to browse posts, comments, and subreddit listings.
Features
Post pages — fetches title, body, metadata, and threaded comments
Subreddit listings — retrieves post listings from any subreddit
User pages — browses a user's post history
Short links — automatically expands
redd.itURLsSafety built-in — untrusted content disclaimer, text truncation, timeout protection, rate limit handling
Related MCP server: reddit-mcp
Requirements
Node.js 22+
Installation
git clone https://github.com/quzma/reddit-mcp.git
cd reddit-mcp
npm install
npm run buildUsage
Claude Desktop
Add to your Claude Desktop MCP config (claude_desktop_config.json):
{
"mcpServers": {
"reddit": {
"command": "node",
"args": ["/absolute/path/to/reddit-mcp/dist/index.js"]
}
}
}Claude Code
Add to your Claude Code MCP settings:
claude mcp add reddit -- node /absolute/path/to/reddit-mcp/dist/index.jsDevelopment
npm run devTool
fetch_reddit
Fetch content from a Reddit URL.
Parameter | Type | Required | Description |
| string | Yes | Reddit URL (post, subreddit, or user page) |
| number | No | Max top-level comments to include (0-50, default 15) |
Supported URL formats:
https://reddit.com/r/subreddit/comments/id/title/https://reddit.com/r/subreddit/https://reddit.com/user/username/https://redd.it/idOld/new/www Reddit URL variants
How It Works
Uses Reddit's public JSON API — no API keys or OAuth needed. The server communicates over stdio using the MCP protocol, so it works as a local tool for any MCP-compatible client.
Content safety measures:
All output is prefixed with an untrusted-content disclaimer
Post/comment text truncated at 20,000 characters
Comment nesting limited to 2 levels, 5 replies per comment
15-second request timeout
Rate limit (429) and forbidden (403) error handling
License
MIT — see LICENSE
This server cannot be deployed
Maintenance
Related MCP Connectors
Reddit MCP — public Reddit data via JSON endpoints (no auth required)
Reddit MCP server: search posts, subreddit feeds, comments & user profiles as JSON. No API key.
Lemmy MCP — public reads on any Lemmy instance.
Browse and manage Reddit posts, comments, and threads. Fetch user activity, explore hot/new/rising…
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA read-only Model Context Protocol server that enables browsing subreddits, searching within subreddits, retrieving comment trees, and looking up user activity on Reddit via natural language.-
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server that connects to the Reddit Data API to search posts, browse subreddits, read comments, view user profiles, and check trending content through the Model Context Protocol.151MIT
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to Reddit through 8 tools for searching, browsing, and retrieving posts, comments, and user data, compatible with any MCP client.MIT
- AlicenseNot gradedqualityBmaintenanceA local, read-only Reddit MCP server that provides tools for searching posts, retrieving posts/comments, subreddit information, and user content via the official Reddit Data API with caching and privacy-focused features.-