playbooks

home / mcp / reddit mcp server

Reddit MCP Server

Provides read-only access to Reddit data via MCP endpoints for browsing, searching, and reading content.

Installation
Add the following to your MCP client configuration file.

Configuration

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

You can run a plug-and-play MCP server that lets you browse, search, and read Reddit content through any MCP client. It supports read-only operations and uses the PRAW-based backend to handle Reddit data with built-in rate limiting.

How to use

You connect to the Reddit MCP server from your MCP client. The server exposes functions to fetch a subreddit, read a submission, access comments, and perform search queries across posts and subreddits. Use these endpoints to build workflows that read Reddit data, answer questions, or surface content in your own apps without writing Reddit API calls yourself.

How to install

Prerequisites you need before installing: Python and a way to run MCP servers (uvx) on your machine.

Install the Python MCP package and configure the server with your Reddit API credentials.

Choose one of the following installation methods and place the configuration in your MCP setup file.

Configuring and running the Reddit MCP server

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

Alternative: Python package run

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

Environment variables

You must provide Reddit credentials to authorize the MCP server. The required environment variables are shown in the configuration snippets.

Tools exposed by the server

The server exposes the following tools to query Reddit data.

Available tools

- 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

Available tools

get_comment

Fetch a single Reddit comment by its identifier.

get_comments_by_submission

Retrieve all comments for a specific submission (post).

get_submission

Retrieve a Reddit submission (post) by its identifier.

get_subreddit

Retrieve details for a subreddit by name.

search_posts

Search for posts within a subreddit using query terms.

search_subreddits

Search subreddits by name or description.