home / mcp / reddit mcp server

Reddit MCP Server

Provides read-only access to Reddit data via MCP: search posts, view post details, and fetch subreddit info.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "geli2001-reddit-mcp": {
      "command": "uvx",
      "args": [
        "reddit-mcp-tool@latest"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "YOUR_CLIENT_ID",
        "REDDIT_USER_AGENT": "reddit-mcp-tool:v0.2.0 (by /u/yourusername)",
        "REDDIT_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

You can use this MCP server to read and explore Reddit content through MCP-compatible clients. It provides read-only access to search posts, fetch post details, and retrieve subreddit information, all via a lightweight FastMCP-based integration. This makes it easy to build tools and dashboards that browse Reddit data without manual API handling.

How to use

Connect your MCP client to the server using a stdio transport and start the local MCP service. Once connected, you can search for posts within a specific subreddit, perform site-wide searches, fetch detailed information about posts, retrieve subreddit info, and get hot posts from a subreddit. Focus on practical tasks like discovering new posts in a topic, comparing post details, or quickly inspecting subreddit statistics.

How to install

Prerequisites: You need Python 3.10 or newer and the uv runtime tool available on your system.

uvx

uv
python --version

# Ensure you have a Reddit app and credentials ready before starting the server.

Configuration and usage notes

This server uses environment variables to authenticate with Reddit’s API. You will provide the Reddit client ID, client secret, and a user agent string. Two standard runtime configurations are shown for running the MCP server locally via the uv runtimes.

// Environment variables to set (examples)
REDDIT_CLIENT_ID=your_client_id_here
REDDIT_CLIENT_SECRET=your_client_secret_here
REDDIT_USER_AGENT=reddit-mcp-tool:v0.2.0 (by /u/yourusername)

Troubleshooting

If you encounter issues, verify that your Reddit API credentials are correct, your environment variables are exported in the shell or provided to the runtime, and that network access to Reddit’s API is not blocked. Common problems include invalid credentials, authentication failures, and rate limiting errors.

Notes

This tool is read-only and adheres to Reddit API rate limits. It relies on FastMCP for serialization and MCP compatibility, and it supports standard MCP clients over stdio transport.

Available tools

search_reddit_posts

Search posts within a specific subreddit with options for sorting and filtering.

search_reddit_all

Perform a site-wide search across Reddit for a given query with sorting and time filters.

get_reddit_post_details

Fetch comprehensive details for a specific Reddit post by ID.

get_subreddit_info

Retrieve detailed information about a subreddit.

get_hot_reddit_posts

Get hot posts from a chosen subreddit with an optional limit.