Reddit MCP
Provides tools for browsing, searching, and reading Reddit content, including access to submissions, comments, and subreddits.
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 MCP Show me hot posts in r/science"
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 plug-and-play MCP server to browse, search, and read Reddit.
Demo
Here's a short video showing how to use this in Claude Desktop:
https://github.com/user-attachments/assets/a2e9f2dd-a9ac-453f-acd9-1791380ebdad
Related MCP server: MCP Reddit Server
Features
Detailed parameter validation with pydantic
Uses the reliable PRAW library under the hood
Built-in rate limiting protection thanks to PRAW
Caveats
Only supports read features for now. If you want to use write features, upvote the issue or send a PR! π
Tools use tokens. To use this with Claude, you may need to be a Pro user to use many tool calls. Free tier users should be fine with lighter tool usage. Your token usage is your responsibility.
Installation
Prerequisite: Reddit API credentials
Create a developer app in your Reddit account if you don't already have one. This will give you a client_id and client_secret to use in the following steps. If you already have these, you can skip this step.
Claude Desktop
To install into Claude Desktop:
Follow the instructions here until the section "Open up the configuration file in any text editor."
Add the following to the file depending on your preferred installation method:
Using uvx (recommended)
"mcpServers": {
"reddit": {
"command": "uvx",
"args": ["reddit-mcp"],
"env": {
"REDDIT_CLIENT_ID": "<client_id>",
"REDDIT_CLIENT_SECRET": "<client_secret>"
}
}
}Using PIP
First install the package:
pip install reddit-mcpThen add the following to the configuration file:
"mcpServers": {
"reddit": {
"command": "python",
"args": ["-m", "reddit_mcp"],
"env": {
"REDDIT_CLIENT_ID": "<client_id>",
"REDDIT_CLIENT_SECRET": "<client_secret>"
}
}
}Others
You can use this server with any MCP client, including agent frameworks (LangChain, LlamaIndex, AutoGen, etc). For an example AutoGen integration, check out the example.
Tools
The tools the server will expose are:
Name | Description |
| Access a comment |
| Access comments of a submission |
| Access a submission |
| Access a subreddit by name |
| Search posts in a subreddit |
| Search subreddits by name or description |
Contributing
Contributions are welcome! See CONTRIBUTING.md for more information.
Acknowledgments
PRAW for an amazingly reliable library π
Available Tools
6 toolsget_comment_by_idA
Retrieve a specific comment by ID.
Args:
comment_id: ID of the comment to retrieve
Returns:
Comment details with any replies
Inputs: comment_id (required).
get_comments_by_submissionA
Retrieve comments from a specific submission.
Args:
submission_id: ID of the submission to get comments from
replace_more: Whether to replace MoreComments objects with actual comments
Returns:
List of comments with their replies
Inputs: submission_id (required), replace_more.
get_submissionA
Retrieve a specific submission by ID.
Args:
submission_id: ID of the submission to retrieve
Returns:
Detailed information about the submission
Inputs: submission_id (required).
get_subredditB
Retrieve a subreddit by name.
Args:
subreddit_name: Name of the subreddit to retrieve
Returns:
Detailed information about the subreddit
Inputs: subreddit_name (required).
search_postsC
Search for posts within a subreddit.
Args:
params: Search parameters including subreddit name, query, and filters
Returns:
List of matching posts with their details
Inputs: params (required).
search_subredditsC
Search for subreddits using either name-based or description-based search.
Args:
by: Search parameters, either SearchByName or SearchByDescription
Returns:
List of matching subreddits with their details
Inputs: by (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 6 tools
Each tool targets a distinct Reddit resource (comment, submission, subreddit) or action (searching posts vs subreddits), with no overlapping purposes.
All tool names follow a consistent 'verb_noun' pattern in snake_case, using 'get_' for retrieval and 'search_' for searching.
Six tools provide a well-scoped set for basic Reddit operations without being too few or too many.
Covers core read operations (submissions, comments, subreddits, search) but lacks tools for listing subreddit feeds or user profiles, which are minor gaps.
Maintenance
Related MCP Connectors
Search public Reddit posts, browse subreddit feeds, and read posts, comments, and profiles.
Browse and manage Reddit posts, comments, and threads. Fetch user activity, explore hot/new/risingβ¦
Search, monitor and measure Reddit posts and comments. Previews work with no API key.
Reddit posts, full comment trees, searches, subreddits and users, as JSON or Markdown for LLMs.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables comprehensive Reddit interaction including fetching posts, analyzing users and subreddits, searching content, and creating posts/comments. Supports both read-only mode with client credentials and full functionality with user authentication.171,938 npmMIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with Reddit by searching subreddits, retrieving hot posts, and fetching detailed post information with comments through the Reddit API.-
- FlicenseNot gradedqualityCmaintenanceEnables interaction with Reddit through the Reddit API, allowing users to search posts, retrieve saved content, fetch comments, reply to comments, and access detailed post information with comment trees.4-
- FlicenseNot gradedqualityCmaintenanceEnables reading subreddit posts, comments, user profiles, searching Reddit, and submitting posts, comments, or votes via natural language commands.-