Reddit Mcp
What is Reddit Mcp
reddit-mcp is a plug-and-play MCP server designed to browse, search, and read content from Reddit efficiently.
Use cases
Use cases include browsing Reddit posts, searching for specific topics, and reading comments, with potential for future write capabilities.
How to use
To use reddit-mcp, you need to install it via Claude Desktop or using PIP. Ensure you have Reddit API credentials (client_id and client_secret) before configuration.
Key features
Key features include detailed parameter validation using Pydantic, integration with the reliable PRAW library, and built-in rate limiting protection.
Where to use
reddit-mcp can be used in applications that require access to Reddit’s content, such as data analysis, content aggregation, or building Reddit-based tools.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Reddit Mcp
reddit-mcp is a plug-and-play MCP server designed to browse, search, and read content from Reddit efficiently.
Use cases
Use cases include browsing Reddit posts, searching for specific topics, and reading comments, with potential for future write capabilities.
How to use
To use reddit-mcp, you need to install it via Claude Desktop or using PIP. Ensure you have Reddit API credentials (client_id and client_secret) before configuration.
Key features
Key features include detailed parameter validation using Pydantic, integration with the reliable PRAW library, and built-in rate limiting protection.
Where to use
reddit-mcp can be used in applications that require access to Reddit’s content, such as data analysis, content aggregation, or building Reddit-based tools.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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 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)
Using PIP
First install the package:
pip install reddit-mcp
Then add the following to the configuration file:
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 |
|---|---|
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 CONTRIBUTING.md for more information.
Acknowledgments
- PRAW for an amazingly reliable library 💙
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
