Skip to content
Back to search

reddit-mcp

Model Context Protocol server implementation for Reddit

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/arindam200--reddit-mcp/badge.svg)](/listings/arindam200--reddit-mcp)

HTML

<a href="/listings/arindam200--reddit-mcp"><img src="/api/listings/arindam200--reddit-mcp/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.

1. Clone this repository

git clone https://github.com/Arindam200/reddit-mcp.git
cd reddit-mcp

2. **Connect to the MCP server**

Copy the below json with the appropriate {{PATH}} values:

   {
     "mcpServers": {
       "reddit": {
         "command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here
         "args": [
           "--directory",
           "{{PATH_TO_SRC}}", // cd into the repo, run `pwd` and enter the output here
           "run",
           "server.py"
         ],
         "env": {
           "REDDIT_CLIENT_ID": "your_client_id",
           "REDDIT_CLIENT_SECRET": "your_client_secret",
           "REDDIT_USERNAME": "your_username", // Optional for authenticated operations
           "REDDIT_PASSWORD": "your_password" // Optional for authenticated operations
         }
       }
     }
   }

You can obtain Reddit API credentials by creating an app at [Reddit's app preferences page](https://www.reddit.com/prefs/apps).

For **Claude**, save this as `claude_desktop_config.json` in your Claude Desktop configuration directory at:

   ~/Library/Application Support/Claude/claude_desktop_config.json

For **Cursor**, save this as `mcp.json` in your Cursor configuration directory at:

   ~/.cursor/mcp.json

3. **Restart Claude Desktop / Cursor**

Open Claude Desktop and you should now see Reddit as an available integration.

Or restart Cursor.

Available Tools

The server provides the following tools:

Read-only Tools (require only client credentials):

- `get_user_info(username)` - Get detailed user analysis with engagement insights - `get_user_comments(username, sort, time_filter, limit)` - Get a user's comment history with filtering options - `get_user_posts(username, sort, time_filter, limit)` - Get a user's post/submission history with filtering options - `get_top_posts(subreddit, time_filter, limit)` - Get and analyze top posts - `search_posts(query, subreddit, sort, time_filter, limit)` - Search for posts across Reddit or within a specific subreddit - `get_subreddit_stats(subreddit)` - Get comprehensive subreddit analysis - `get_trending_subreddits()` - Get list of trending subreddits - `get_submission_by_url(url)` - Get a Reddit submission by its URL - `get_submission_by_id(submission_id)` - Get a Reddit submission by its ID

Authenticated Tools (require user credentials):

- `who_am_i()` - Get information about the currently authenticated user - `create_post(subreddit, title, content, flair, is_self)` - Create an optimized post - `reply_to_post(post_id, content, subreddit)` - Add a reply with engagement insights - `reply_to_comment(comment_id, content, subreddit)` - Add a strategic reply

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 · 179 lines

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

  1. # Reddit MCP Server
  2. This repository contains a Model Context Protocol server implementation for Reddit that allows AI assistants to access and interact with Reddit content through PRAW (Python Reddit API Wrapper).
  3. <a href="https://glama.ai/mcp/servers/@Arindam200/reddit-mcp">
  4. <img width="380" height="200" src="https://glama.ai/mcp/servers/@Arindam200/reddit-mcp/badge" alt="Reddit Server MCP server" />
  5. </a>
  6. ![image](./Demo.png)
  7. ## What is MCP?
  8. The Model Context Protocol (MCP) is a standard for enabling AI assistants to interface with external services, tools, and data sources. This server implements the MCP specification to provide access to Reddit content.
  9. To know more about MCP, Check this [video](https://www.youtube.com/watch?v=BwB1Jcw8Z-8)
  10. ## Features
  11. - Get detailed user information with engagement analysis
  12. - Retrieve user comment and post history with flexible filtering
  13. - Fetch and analyze top posts from any subreddit
  14. - Search for posts across all of Reddit or within specific subreddits using search terms
  15. - Get comprehensive subreddit statistics and health metrics
  16. - View trending subreddits with growth patterns
  17. - Create strategic posts with timing recommendations
  18. - Reply to posts and comments with engagement optimization
  19. - AI-driven insights and recommendations
  20. - Smart response formatting with engagement metrics
  21. ## Installation
  22. 1. Clone this repository
  23. ```bash
  24. git clone https://github.com/Arindam200/reddit-mcp.git
  25. cd reddit-mcp
  26. ```
  27. 2. **Connect to the MCP server**
  28. Copy the below json with the appropriate {{PATH}} values:
  29. ```json
  30. {
  31. "mcpServers": {
  32. "reddit": {
  33. "command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here
  34. "args": [
  35. "--directory",
  36. "{{PATH_TO_SRC}}", // cd into the repo, run `pwd` and enter the output here
  37. "run",
  38. "server.py"
  39. ],
  40. "env": {
  41. "REDDIT_CLIENT_ID": "your_client_id",
  42. "REDDIT_CLIENT_SECRET": "your_client_secret",
  43. "REDDIT_USERNAME": "your_username", // Optional for authenticated operations
  44. "REDDIT_PASSWORD": "your_password" // Optional for authenticated operations
  45. }
  46. }
  47. }
  48. }
  49. ```
  50. You can obtain Reddit API credentials by creating an app at [Reddit's app preferences page](https://www.reddit.com/prefs/apps).
  51. For **Claude**, save this as `claude_desktop_config.json` in your Claude Desktop configuration directory at:
  52. ```
  53. ~/Library/Application Support/Claude/claude_desktop_config.json
  54. ```
  55. For **Cursor**, save this as `mcp.json` in your Cursor configuration directory at:
  56. ```
  57. ~/.cursor/mcp.json
  58. ```
  59. 3. **Restart Claude Desktop / Cursor**
  60. Open Claude Desktop and you should now see Reddit as an available integration.
  61. Or restart Cursor.
  62. ### Available Tools
  63. The server provides the following tools:
  64. #### Read-only Tools (require only client credentials):
  65. - `get_user_info(username)` - Get detailed user analysis with engagement insights
  66. - `get_user_comments(username, sort, time_filter, limit)` - Get a user's comment history with filtering options
  67. - `get_user_posts(username, sort, time_filter, limit)` - Get a user's post/submission history with filtering options
  68. - `get_top_posts(subreddit, time_filter, limit)` - Get and analyze top posts
  69. - `search_posts(query, subreddit, sort, time_filter, limit)` - Search for posts across Reddit or within a specific subreddit
  70. - `get_subreddit_stats(subreddit)` - Get comprehensive subreddit analysis
  71. - `get_trending_subreddits()` - Get list of trending subreddits
  72. - `get_submission_by_url(url)` - Get a Reddit submission by its URL
  73. - `get_submission_by_id(submission_id)` - Get a Reddit submission by its ID
  74. #### Authenticated Tools (require user credentials):
  75. - `who_am_i()` - Get information about the currently authenticated user
  76. - `create_post(subreddit, title, content, flair, is_self)` - Create an optimized post
  77. - `reply_to_post(post_id, content, subreddit)` - Add a reply with engagement insights
  78. - `reply_to_comment(comment_id, content, subreddit)` - Add a strategic reply
  79. ## Example Queries
  80. Here are some examples of what you can ask an AI assistant connected to this server:
  81. - "Who am I on Reddit?" or "Show my Reddit profile"
  82. - "Analyze u/spez's Reddit activity"
  83. - "Show me u/spez's recent comments"
  84. - "Get the top posts by u/poem_for_your_sprog from the past year"
  85. - "Show me the most controversial comments by u/username"
  86. - "Show me the top posts from r/Python this week"
  87. - "Search for posts about 'machine learning' across all of Reddit"
  88. - "Find posts about 'beginner tutorials' in r/learnprogramming from this month"
  89. - "Get statistics about r/AskReddit"
  90. - "What are the trending subreddits right now?"
  91. - "Create a post in r/Python about a new project"
  92. - "Reply to this post with an insightful comment"
  93. - "What's the best time to post in this subreddit?"
  94. ## Advanced Features
  95. ### AI-Driven Analysis
  96. The server provides intelligent analysis in several areas:
  97. 1. **User Analysis**
  98. - Engagement patterns
  99. - Activity trends
  100. - Community influence
  101. - Personalized recommendations
  102. 2. **Post Analysis**
  103. - Performance metrics
  104. - Engagement quality
  105. - Timing optimization
  106. - Content impact assessment
  107. 3. **Community Analysis**
  108. - Health indicators
  109. - Growth patterns
  110. - Activity metrics
  111. - Engagement opportunities
  112. ### Smart Response Formatting
  113. - Organized bullet points
  114. - Engagement statistics
  115. - AI-driven insights
  116. - Strategic recommendations
  117. - Performance metrics
  118. ## Authentication
  119. The server supports two levels of authentication:
  120. 1. **Read-only Access**
  121. - Requires: `client_id` and `client_secret`
  122. - Allows: Fetching public data, reading posts/comments
  123. 2. **Authenticated Access**
  124. - Requires: All read-only credentials PLUS `username` and `password`
  125. - Allows: All read-only operations PLUS posting and commenting
  126. ## Contributing
  127. Contributions are welcome! Please feel free to submit a Pull Request.
  128. ## License
  129. This project is licensed under the MIT License - see the LICENSE file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

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