Reddit MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to Reddit data. Built on top of redd. It works without API keys where Reddit allows anonymous access, and can use optional Reddit OAuth credentials where it doesn't.

https://github.com/user-attachments/assets/af8ae52c-f9f3-4d04-80d5-4be0dfa61b0f

Table of Contents

1. Features
2. Quick Start
3. Available Tools
4. Configuration
5. Architecture
6. Contributing
7. License

1. Features

• 🔍 Search — Search all of Reddit or within a specific subreddit
• 📰 Subreddit Posts — Browse hot, top, new, or rising posts from any subreddit
• 📖 Post Details — Get full post content with nested comment trees
• 👤 User Activity — View a user's recent posts and comments
• 📝 User Posts — Get a user's submitted posts

No browser required, and API keys are optional. Reddit now blocks unauthenticated requests from many networks (you'll see HTTP 403 ... blocked by network security). If that happens to you, add Reddit API credentials.

2. Quick Start

2.1. Using uvx (recommended)

The fastest way to run the server — no clone needed:

# stdio transport (default, for Claude Desktop / Cursor / etc.)
uvx reddit-no-auth-mcp-server

# HTTP transport
uvx reddit-no-auth-mcp-server \
  --transport streamable-http \
  --port 8000

2.2. From source

git clone https://github.com/eliasbiondo/reddit-mcp-server.git
cd reddit-mcp-server
uv sync

Run the server:

# stdio transport (default)
uv run reddit-no-auth-mcp-server

# HTTP transport
uv run reddit-no-auth-mcp-server \
  --transport streamable-http \
  --port 8000

2.3. MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "reddit": {
      "command": "uvx",
      "args": ["reddit-no-auth-mcp-server"]
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "reddit": {
      "command": "uvx",
      "args": ["reddit-no-auth-mcp-server"]
    }
  }
}

From source (any MCP client)

{
  "mcpServers": {
    "reddit": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/reddit-mcp-server",
        "run", "reddit-no-auth-mcp-server"
      ]
    }
  }
}

3. Available Tools

Every tool returns a JSON object (never a bare array) that matches its advertised outputSchema, so MCP-to-OpenAPI bridges such as mcpo / Open WebUI can validate the response.

Tool Details

search

Search all of Reddit for posts matching a query.

query: "python a

... [View full README on GitHub](https://github.com/eliasbiondo/reddit-mcp-server#readme)