Glama
Sign In

Reddit MCP

by GridfireAI
GitHub
Python
MIT License
6
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Supports integration with LangChain agent frameworks for utilizing Reddit browsing and search capabilities.

  • Provides tools for browsing, searching, and reading Reddit content, including accessing comments, submissions, and subreddits, as well as searching posts and subreddits through the Reddit API.

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

NameDescription
get_commentAccess a comment
get_comments_by_submissionAccess comments of a submission
get_submissionAccess a submission
get_subredditAccess a subreddit by name
search_postsSearch posts in a subreddit
search_subredditsSearch subreddits by name or description

Contributing

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

Acknowledgments

  • PRAW for an amazingly reliable library 💙

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A plug-and-play MCP server that enables AI assistants to browse, search, and read Reddit content through the PRAW library.

  1. Demo
    1. Features
      1. Caveats
        1. Installation
          1. Prerequisite: Reddit API credentials
          2. Claude Desktop
          3. Using uvx (recommended)
          4. Using PIP
          5. Others
        2. Tools
          1. Contributing
            1. Acknowledgments

              Related Resources