reddit-mcp

A plug-and-play MCP server to browse, search, and read Reddit.

Here's a short video showing how to use this in Claude Desktop:

• Detailed parameter validation with pydantic
• Uses the reliable PRAW library under the hood
• Built-in rate limiting protection thanks to PRAW

• 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.

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.

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:

"mcpServers": {
  "reddit": {
    "command": "uvx",
    "args": ["reddit-mcp"],
    "env": {
      "REDDIT_CLIENT_ID": "<client_id>",
      "REDDIT_CLIENT_SECRET": "<client_secret>"
    }
  }
}

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>"
    }
  }
}

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.

The tools the server will expose are:

Contributions are welcome! See CONTRIBUTING.md for more information.

• PRAW for an amazingly reliable library 💙