reddit-mcp
If you are the rightful owner of reddit-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A plug-and-play MCP server to browse, search, and read Reddit.
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
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 ! 🙌
- 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-mcp
Then 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 .
Tools
The tools the server will expose are:
| Name | Description |
|---|---|
get_comment | Access a comment |
get_comments_by_submission | Access comments of a submission |
get_submission | Access a submission |
get_subreddit | Access a subreddit by name |
search_posts | Search posts in a subreddit |
search_subreddits | Search subreddits by name or description |
Contributing
Contributions are welcome! See for more information.
Acknowledgments
- PRAW for an amazingly reliable library 💙
