MCP Reddit

v1.0.0Search & Data Extractionstable

A Model Context Protocol (MCP) server that provides tools for fetching and analyzing Reddit content.

llmmcpmodel-context-protocolreddit
Share:
401
Stars
0
Downloads
0
Weekly
0/5

What is MCP Reddit?

MCP Reddit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server that provides tools for fetching and analyzing reddit content.

A Model Context Protocol (MCP) server that provides tools for fetching and analyzing Reddit content.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server that provides tools fo

Use Cases

Reddit content fetching
Community analysis and monitoring
Content aggregation
adhikasp

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-reddit

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Reddit

MCP Reddit is a Model Context Protocol server that lets AI assistants browse and analyze Reddit content in real time. It exposes tools for fetching hot threads from any subreddit and retrieving detailed post content including comments, supporting text posts, link posts, and gallery posts. Developers and researchers use it to monitor communities, aggregate trending discussions, or pull contextual data from Reddit during AI-assisted workflows.

Prerequisites

  • Python 3.8+ runtime with uvx (from the uv package manager) installed
  • An MCP-compatible client such as Claude Desktop or Cursor
  • Git installed for the manual uvx-from-git installation method
  • No Reddit API key required — the server uses public Reddit endpoints
1

Install via Smithery (Automated)

The fastest way to install mcp-reddit for Claude Desktop is through the Smithery CLI, which automatically configures the client.

npx -y @smithery/cli install @adhikasp/mcp-reddit --client claude
2

Or Install Manually with uvx

If you prefer manual setup, install uvx (part of the uv Python package manager) and then add the server to your MCP client configuration.

# Install uv (which includes uvx)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Verify uvx is available
uvx --version
3

Configure Claude Desktop

Add the mcp-reddit server to your Claude Desktop configuration file. The server is run via uvx directly from the GitHub repository with no local clone required.

{
  "mcpServers": {
    "reddit": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/adhikasp/mcp-reddit.git", "mcp-reddit"],
      "env": {}
    }
  }
}
4

Restart Claude Desktop

After saving the configuration file, fully quit and relaunch Claude Desktop. The mcp-reddit server will appear in the connected tools list.

5

Fetch Hot Threads from a Subreddit

Use the fetch_hot_threads tool by asking Claude a natural language question about a subreddit. The tool accepts a subreddit name parameter and returns current trending posts.

# Example natural language query:
"What are the latest hot threads in r/programming?"

MCP Reddit Examples

Client configuration

Claude Desktop configuration for mcp-reddit using uvx to run directly from the GitHub repository.

{
  "mcpServers": {
    "reddit": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/adhikasp/mcp-reddit.git",
        "mcp-reddit"
      ],
      "env": {}
    }
  }
}

Prompts to try

Natural language prompts that demonstrate the capabilities of the mcp-reddit MCP server.

- "What are the latest hot threads in r/victoria3?"
- "Summarize the top 5 posts in r/MachineLearning this week"
- "Show me the comments on the top post in r/worldnews"
- "What's trending in r/python right now?"

Troubleshooting MCP Reddit

uvx command not found after installation

Make sure you have uv installed and that its bin directory is in your PATH. Run 'source ~/.bashrc' or restart your terminal after installing uv. On macOS, try 'export PATH=$HOME/.local/bin:$PATH'.

Rate limiting or empty responses from Reddit

Reddit's public API has rate limits for unauthenticated requests. If you get empty results or errors, wait a minute and try again. Avoid running many requests in quick succession.

Server does not appear in Claude Desktop after configuration

Ensure the configuration file is valid JSON with no trailing commas. Fully quit Claude Desktop (not just close the window) and relaunch. Check Claude Desktop logs for connection errors.

Frequently Asked Questions about MCP Reddit

What is MCP Reddit?

MCP Reddit is a Model Context Protocol (MCP) server that model context protocol (mcp) server that provides tools for fetching and analyzing reddit content. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Reddit?

Follow the installation instructions on the MCP Reddit GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Reddit?

MCP Reddit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Reddit free to use?

Yes, MCP Reddit is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-reddit": { "command": "npx", "args": ["-y", "mcp-reddit"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Reddit?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides