Reddit MCP

🚀 Reddit MCP GitHub Project

A plug-and-play MCP server for browsing, searching, and reading Reddit.

🚀 Quick Start

This is a plug-and-play MCP server that allows you to browse, search, and read Reddit. You can refer to the following content for detailed usage.

🎥 Demo Video

Here is a short video demonstrating how to use it in Claude Desktop: https://github.com/user-attachments/assets/a2e9f2dd-a9ac-453f-acd9-1791380ebdad

✨ Features

• Utilizes pydantic for detailed parameter validation.
• Relies on the reliable PRAW library as backend support.
• Incorporates built - in rate limit protection thanks to PRAW's capabilities.

📄 Important Notes

⚠️ Important Note

Currently, only read functionality is supported. If you want to use the write functionality, please vote on the issue or contribute code! 🙌

💡 Usage Tip

The tool uses tokens. To use this tool with Claude, you may need to be a Pro user for multiple tool calls. Free users can also easily make lightweight tool calls. Use tokens at your own risk.

📦 Installation

Prerequisites: Reddit API Credentials

If you don't have Reddit API credentials yet, create a developer application. This will provide you with client_id and client_secret for the subsequent steps. If you already have this information, you can skip this step.

Installation in Claude Desktop

Follow these steps:

• Follow the instructions here until the section "Open the configuration file in any text editor".
• Add the following content to the file according to 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>"
    }
  }
}

Installing via PIP

First, install the package:

pip install reddit-mcp

Then, add the following content to the configuration file:

"mcpServers": {
  "reddit": {
    "command": "python",
    "args": ["-m", "reddit_mcp"],
    "env": {
      "REDDIT_CLIENT_ID": "<client_id>",
      "REDDIT_CLIENT_SECRET": "<client_secret>"
    }
  }
}

Other Methods

You can use any MCP client, including various proxy frameworks (such as LangChain, LlamaIndex, AutoGen, etc.). For an example of AutoGen integration, check out the example.

🛠️ Provided Tools

The server will expose the following tools:

🤝 Contribution Guide

Contributions are welcome! For detailed information, please refer to CONTRIBUTING.md.

🙏 Acknowledgments

• Thanks to the support of the PRAW library.