Skip to main content

Reddit MCP

License: MIT

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:
"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 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 💙

Metadata

Release files for iflow-mcp_gridfireai-reddit-mcp 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_gridfireai-reddit-mcp 0.1.2
File Size Uploaded Provenance Actions
iflow_mcp_gridfireai_reddit_mcp-0.1.2.tar.gz 8.5 kB Without provenance Details for iflow_mcp_gridfireai_reddit_mcp-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_gridfireai-reddit-mcp 0.1.2
File Interpreter ABI Platform Actions
iflow_mcp_gridfireai_reddit_mcp-0.1.2-py3-none-any.whl Python 3 none any Details for iflow_mcp_gridfireai_reddit_mcp-0.1.2-py3-none-any.whl

Total release size: 19.6 kB

Release files / iflow_mcp_gridfireai_reddit_mcp-0.1.2.tar.gz

Download URL iflow_mcp_gridfireai_reddit_mcp-0.1.2.tar.gz
Size 8.5 kB
Tags Source
SHA-256 checksum
How to use checksums
4ccb218990b6c48d142773298d2a964939fac92749389ec35d919aea5b75a61f
BLAKE2b-256 checksum
How to use checksums
d95ce2316628d29cb51ea0f7e6b90343a69fc98c42aa19e2f3549654ab2bbcbb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_gridfireai_reddit_mcp-0.1.2-py3-none-any.whl

Download URL iflow_mcp_gridfireai_reddit_mcp-0.1.2-py3-none-any.whl
Size 11.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f3bba3faf5802c9e32881689ca60ea3d3d9534d5943f7a5cca3080c67974b5a2
BLAKE2b-256 checksum
How to use checksums
7e688452c85da413079acdbbb12be301c33b557789731892bc0ae43a6e82a45f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for iflow-mcp_gridfireai-reddit-mcp 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page