Reddit

Reddit MCP

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A plug-and-play [MCP](https://modelcontextprotocol.io) 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](https://docs.pydantic.dev)

Uses the reliable [PRAW](https://praw.readthedocs.io/) 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](https://github.com/GridfireAI/reddit-mcp/issues/1) or [send a PR](CONTRIBUTING.md)!

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](https://www.reddit.com/prefs/apps) 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](https://modelcontextprotocol.io/quickstart/user) 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](https://docs.astral.sh/uv/guides/tools/) (recommended)

Using PIP

First install the package:

Then add the following to the configuration file:

Others

You can use this server with any [MCP client](https://modelcontextprotocol.io/docs/clients), including agent frameworks (LangChain, LlamaIndex, AutoGen, etc). For an example AutoGen integration, check out the [example](examples/autogen).

Tools

The tools the server will expose are:

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Contributing

Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.

Acknowledgments

[PRAW](https://praw.readthedocs.io/) for an amazingly reliable library