Reddit

v1.0.0Search & Data Extractionstable

A server allowing interaction with Reddit via the public API, enabling browsing frontpage posts, retrieving subreddit details, and reading post comments through a Model Context Protocol.

mcp-server-redditmcpai-integration
Share:
177
Stars
0
Downloads
0
Weekly
0/5

What is Reddit?

Reddit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to server allowing interaction with reddit via the public api, enabling browsing frontpage posts, retrieving subreddit details, and reading post comments through a model context protocol.

A server allowing interaction with Reddit via the public API, enabling browsing frontpage posts, retrieving subreddit details, and reading post comments through a Model Context Protocol.

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

Features

  • A server allowing interaction with Reddit via the public API

Use Cases

Browse Reddit frontpage posts and subreddit content.
Read post comments and discussions through MCP.
Search Reddit data using natural language.
Hawstein

Maintainer

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

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-server-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 Reddit

MCP Server Reddit connects AI models to Reddit's public API, enabling browsing of frontpage posts, subreddit details, post content, and threaded comments — all without requiring a Reddit API key. It exposes eight tools covering hot, new, top, and rising feeds with configurable post limits, time ranges, and comment depth. Developers and researchers use it to bring live Reddit discussions into AI workflows for sentiment analysis, trend monitoring, or community research.

Prerequisites

  • Python 3.10 or later installed (for uvx/pip installation)
  • uv or uvx package manager installed (recommended), or pip
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • No Reddit API key required — uses the public Reddit API
1

Install via uvx (recommended)

Run the server directly using uvx without a manual virtual environment. This is the simplest approach.

uvx mcp-server-reddit
2

Alternatively install via pip

Install the package with pip and run it as a module if you prefer managing your own Python environment.

pip install mcp-server-reddit
python -m mcp_server_reddit
3

Add to your Claude Desktop config

Edit claude_desktop_config.json to register mcp-server-reddit. No environment variables or API keys are required.

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

Restart your MCP client

Restart Claude Desktop or reload Claude Code so the Reddit server is picked up and its tools become available.

5

Test with a simple Reddit query

Ask Claude to fetch the current hot posts from a subreddit to verify the server is working correctly.

Reddit Examples

Client configuration

Register mcp-server-reddit using uvx. No API keys or credentials are needed.

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

Prompts to try

Browse Reddit posts, subreddits, and comments directly from your AI assistant.

- "What are the current hot posts on Reddit's frontpage?"
- "Show me the top posts of all time in r/MachineLearning"
- "Tell me about the r/ClaudeAI subreddit — subscriber count and description"
- "Summarize the top comments on this Reddit post: https://reddit.com/r/..."
- "What are the newest posts in r/programming right now?"

Troubleshooting Reddit

Requests fail with rate limit or 429 errors

Reddit's public API has rate limits. Reduce the frequency of requests or add delays between calls. The server uses the unauthenticated public API, so rate limits are stricter than for OAuth clients.

Comment retrieval returns empty results

Some posts have comments disabled or the thread may be archived. Try a different post, or check the comment depth limit parameter — very deeply nested threads may need a higher depth value.

uvx mcp-server-reddit fails to start

Install uv first: curl -LsSf https://astral.sh/uv/install.sh | sh. If uvx is already installed, try pip install mcp-server-reddit and use 'command': 'python', 'args': ['-m', 'mcp_server_reddit'] as a fallback.

Frequently Asked Questions about Reddit

What is Reddit?

Reddit is a Model Context Protocol (MCP) server that server allowing interaction with reddit via the public api, enabling browsing frontpage posts, retrieving subreddit details, and reading post comments through a model context protocol. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Reddit?

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

Which AI clients work with Reddit?

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

Is Reddit free to use?

Yes, 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-server-reddit": { "command": "npx", "args": ["-y", "mcp-server-reddit"] } } }

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

Read the full setup guide →

Ready to use 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