Skip to content
Back to search

mcp-server-reddit

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hawstein--mcp-server-reddit/badge.svg)](/listings/hawstein--mcp-server-reddit)

HTML

<a href="/listings/hawstein--mcp-server-reddit"><img src="/api/listings/hawstein--mcp-server-reddit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Using [Clinde](https://clinde.ai/) (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`](https://docs.astral.sh/uv/) no specific installation is needed. We will use [`uvx`](https://docs.astral.sh/uv/guides/tools/) 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](https://smithery.ai/server/@Hawstein/mcp-server-reddit):

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 195 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Server Reddit
  2. [![smithery badge](https://smithery.ai/badge/@Hawstein/mcp-server-reddit)](https://smithery.ai/server/@Hawstein/mcp-server-reddit)
  3. 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.
  4. This server uses [redditwarp](https://github.com/Pyprohly/redditwarp) to interact with Reddit's public API and exposes the functionality through MCP protocol.
  5. <a href="https://glama.ai/mcp/servers/4032xr14pu"><img width="380" height="200" src="https://glama.ai/mcp/servers/4032xr14pu/badge" alt="Server Reddit MCP server" /></a>
  6. ## Video Demo (Click to Watch)
  7. A demo in Clinde 👇
  8. [![MCP Server Reddit - Clinde](https://img.youtube.com/vi/1Gdx1jWFbCM/maxresdefault.jpg)](https://youtu.be/1Gdx1jWFbCM)
  9. ## Available Tools
  10. - `get_frontpage_posts` - Get hot posts from Reddit frontpage
  11. - Optional arguments:
  12. - `limit` (integer): Number of posts to return (default: 10, range: 1-100)
  13. - `get_subreddit_info` - Get information about a subreddit
  14. - Required arguments:
  15. - `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')
  16. - `get_subreddit_hot_posts` - Get hot posts from a specific subreddit
  17. - Required arguments:
  18. - `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')
  19. - Optional arguments:
  20. - `limit` (integer): Number of posts to return (default: 10, range: 1-100)
  21. - `get_subreddit_new_posts` - Get new posts from a specific subreddit
  22. - Required arguments:
  23. - `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')
  24. - Optional arguments:
  25. - `limit` (integer): Number of posts to return (default: 10, range: 1-100)
  26. - `get_subreddit_top_posts` - Get top posts from a specific subreddit
  27. - Required arguments:
  28. - `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')
  29. - Optional arguments:
  30. - `limit` (integer): Number of posts to return (default: 10, range: 1-100)
  31. - `time` (string): Time filter for top posts (default: '', options: 'hour', 'day', 'week', 'month', 'year', 'all')
  32. - `get_subreddit_rising_posts` - Get rising posts from a specific subreddit
  33. - Required arguments:
  34. - `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')
  35. - Optional arguments:
  36. - `limit` (integer): Number of posts to return (default: 10, range: 1-100)
  37. - `get_post_content` - Get detailed content of a specific post
  38. - Required arguments:
  39. - `post_id` (string): ID of the post
  40. - Optional arguments:
  41. - `comment_limit` (integer): Number of top-level comments to return (default: 10, range: 1-100)
  42. - `comment_depth` (integer): Maximum depth of comment tree (default: 3, range: 1-10)
  43. - `get_post_comments` - Get comments from a post
  44. - Required arguments:
  45. - `post_id` (string): ID of the post
  46. - Optional arguments:
  47. - `limit` (integer): Number of comments to return (default: 10, range: 1-100)
  48. ## Installation
  49. ### Using [Clinde](https://clinde.ai/) (recommended)
  50. The easiest way to use MCP Server Reddit is through the Clinde desktop app. Simply download and install Clinde, then:
  51. 1. Open the Clinde app
  52. 2. Navigate to the Servers page
  53. 3. Find mcp-server-reddit and click Install
  54. That's it! No technical knowledge required - Clinde handles all the installation and configuration for you seamlessly.
  55. ### Using uv (recommended)
  56. When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
  57. use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-reddit*.
  58. ### Using PIP
  59. Alternatively you can install `mcp-server-reddit` via pip:
  60. ```bash
  61. pip install mcp-server-reddit
  62. ```
  63. After installation, you can run it as a script using:
  64. ```bash
  65. python -m mcp_server_reddit
  66. ```
  67. ### Installing via Smithery
  68. To install MCP Server Reddit for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@Hawstein/mcp-server-reddit):
  69. ```bash
  70. npx -y @smithery/cli install @Hawstein/mcp-server-reddit --client claude
  71. ```
  72. ## Configuration
  73. ### Configure for Claude.app
  74. Add to your Claude settings:
  75. <details>
  76. <summary>Using uvx</summary>
  77. ```json
  78. "mcpServers": {
  79. "reddit": {
  80. "command": "uvx",
  81. "args": ["mcp-server-reddit"]
  82. }
  83. }
  84. ```
  85. </details>
  86. <details>
  87. <summary>Using pip installation</summary>
  88. ```json
  89. "mcpServers": {
  90. "reddit": {
  91. "command": "python",
  92. "args": ["-m", "mcp_server_reddit"]
  93. }
  94. }
  95. ```
  96. </details>
  97. ### Configure for Zed
  98. Add to your Zed settings.json:
  99. <details>
  100. <summary>Using uvx</summary>
  101. ```json
  102. "context_servers": [
  103. "mcp-server-reddit": {
  104. "command": "uvx",
  105. "args": ["mcp-server-reddit"]
  106. }
  107. ],
  108. ```
  109. </details>
  110. <details>
  111. <summary>Using pip installation</summary>
  112. ```json
  113. "context_servers": {
  114. "mcp-server-reddit": {
  115. "command": "python",
  116. "args": ["-m", "mcp_server_reddit"]
  117. }
  118. },
  119. ```
  120. </details>
  121. ## Examples of Questions
  122. - "What are the current hot posts on Reddit's frontpage?" (get_frontpage_posts)
  123. - "Tell me about the r/ClaudeAI subreddit" (get_subreddit_info)
  124. - "What are the hot posts in the r/ClaudeAI subreddit?" (get_subreddit_hot_posts)
  125. - "Show me the newest posts from r/ClaudeAI" (get_subreddit_new_posts)
  126. - "What are the top posts of all time in r/ClaudeAI?" (get_subreddit_top_posts)
  127. - "What posts are trending in r/ClaudeAI right now?" (get_subreddit_rising_posts)
  128. - "Get the full content and comments of this Reddit post: [post_url]" (get_post_content)
  129. - "Summarize the comments on this Reddit post: [post_url]" (get_post_comments)
  130. ## Debugging
  131. You can use the MCP inspector to debug the server. For uvx installations:
  132. ```bash
  133. npx @modelcontextprotocol/inspector uvx mcp-server-reddit
  134. ```
  135. Or if you've installed the package in a specific directory or are developing on it:
  136. ```bash
  137. cd path/to/mcp_server_reddit
  138. npx @modelcontextprotocol/inspector uv run mcp-server-reddit
  139. ```
  140. ## License
  141. 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.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.