Cover image
Try Now
2025-04-14

A Model Context Protocol (MCP) server that provides tools for fetching Reddit content, including frontpage posts, subreddit information and hot posts, post details, and comments.

3 years

Works with Finder

1

Github Watches

3

Github Forks

30

Github Stars

MCP Server Reddit

smithery badge

A Model Context Protocol server providing access to Reddit public API for LLMs. This server enables LLMs to interact with Reddit's content, including browsing frontpage posts, accessing subreddit information, and reading post comments.

This server uses redditwarp to interact with Reddit's public API and exposes the functionality through MCP protocol.

Server Reddit MCP server

Video Demo (Click to Watch)

A demo in Clinde 👇

MCP Server Reddit - Clinde

Available Tools

  • get_frontpage_posts - Get hot posts from Reddit frontpage

    • Optional arguments:
      • limit (integer): Number of posts to return (default: 10, range: 1-100)
  • get_subreddit_info - Get information about a subreddit

    • Required arguments:
      • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
  • get_subreddit_hot_posts - Get hot posts from a specific subreddit

    • Required arguments:
      • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
    • Optional arguments:
      • limit (integer): Number of posts to return (default: 10, range: 1-100)
  • get_subreddit_new_posts - Get new posts from a specific subreddit

    • Required arguments:
      • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
    • Optional arguments:
      • limit (integer): Number of posts to return (default: 10, range: 1-100)
  • get_subreddit_top_posts - Get top posts from a specific subreddit

    • Required arguments:
      • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
    • Optional arguments:
      • limit (integer): Number of posts to return (default: 10, range: 1-100)
      • time (string): Time filter for top posts (default: '', options: 'hour', 'day', 'week', 'month', 'year', 'all')
  • get_subreddit_rising_posts - Get rising posts from a specific subreddit

    • Required arguments:
      • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
    • Optional arguments:
      • limit (integer): Number of posts to return (default: 10, range: 1-100)
  • get_post_content - Get detailed content of a specific post

    • Required arguments:
      • post_id (string): ID of the post
    • Optional arguments:
      • comment_limit (integer): Number of top-level comments to return (default: 10, range: 1-100)
      • comment_depth (integer): Maximum depth of comment tree (default: 3, range: 1-10)
  • get_post_comments - Get comments from a post

    • Required arguments:
      • post_id (string): ID of the post
    • Optional arguments:
      • limit (integer): Number of comments to return (default: 10, range: 1-100)

Installation

Using Clinde (recommended)

The easiest way to use MCP Server Reddit is through the Clinde desktop app. Simply download and install Clinde, then:

  1. Open the Clinde app
  2. Navigate to the Servers page
  3. Find mcp-server-reddit and click Install

That's it! No technical knowledge required - Clinde handles all the installation and configuration for you seamlessly.

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-reddit.

Using PIP

Alternatively you can install mcp-server-reddit via pip:

pip install mcp-server-reddit

After installation, you can run it as a script using:

python -m mcp_server_reddit

Installing via Smithery

To install MCP Server Reddit for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Hawstein/mcp-server-reddit --client claude

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx
"mcpServers": {
  "reddit": {
    "command": "uvx",
    "args": ["mcp-server-reddit"]
  }
}
Using pip installation
"mcpServers": {
  "reddit": {
    "command": "python",
    "args": ["-m", "mcp_server_reddit"]
  }
}

Configure for Zed

Add to your Zed settings.json:

Using uvx
"context_servers": [
  "mcp-server-reddit": {
    "command": "uvx",
    "args": ["mcp-server-reddit"]
  }
],
Using pip installation
"context_servers": {
  "mcp-server-reddit": {
    "command": "python",
    "args": ["-m", "mcp_server_reddit"]
  }
},

Examples of Questions

  • "What are the current hot posts on Reddit's frontpage?" (get_frontpage_posts)
  • "Tell me about the r/ClaudeAI subreddit" (get_subreddit_info)
  • "What are the hot posts in the r/ClaudeAI subreddit?" (get_subreddit_hot_posts)
  • "Show me the newest posts from r/ClaudeAI" (get_subreddit_new_posts)
  • "What are the top posts of all time in r/ClaudeAI?" (get_subreddit_top_posts)
  • "What posts are trending in r/ClaudeAI right now?" (get_subreddit_rising_posts)
  • "Get the full content and comments of this Reddit post: [post_url]" (get_post_content)
  • "Summarize the comments on this Reddit post: [post_url]" (get_post_comments)

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx mcp-server-reddit

Or if you've installed the package in a specific directory or are developing on it:

cd path/to/mcp_server_reddit
npx @modelcontextprotocol/inspector uv run mcp-server-reddit

License

mcp-server-reddit is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • WILLIAM JOEL FOTEPING
  • Friendly music guide for 60s-2000s songs, with links to listen online.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • Khalid kalib
  • Write professional emails

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • https://tovuti.be
  • Oede knorrepot die vasthoudt an de goeie ouwe tied van 't boerenleven

  • Gil kaminski
  • Make sure you are post-ready before you post on social media

  • huahuayu
  • A unified API gateway for integrating multiple etherscan-like blockchain explorer APIs with Model Context Protocol (MCP) support for AI assistants.

  • deemkeen
  • control your mbot2 with a power combo: mqtt+mcp+llm

  • zhaoyunxing92
  • 本项目是一个钉钉MCP(Message Connector Protocol)服务,提供了与钉钉企业应用交互的API接口。项目基于Go语言开发,支持员工信息查询和消息发送等功能。

    Reviews

    4 (1)
    Avatar
    user_R9jL8Lu8
    2025-04-18

    I've been using mcp-server-reddit for a while now and it's an excellent tool for managing and analyzing Reddit data. Created by Hawstein, this server is robust and efficient, allowing for seamless integration with various applications. The detailed documentation and active community support are great bonuses. Highly recommend it for anyone working with Reddit data streams!