-
securityA
license-
qualityMCP server that enables interaction with Reddit, allowing users to read trending posts, analyze discussions, create posts, add comments, and vote on content through Claude and Cursor.
Used for storing and accessing Reddit API credentials and user authentication information through environment variables.
Used for distribution of the MCP server code and documentation.
Runtime environment for executing the MCP server, with configuration options for connecting the server to Claude or other AI tools.
Provides tools for fetching Reddit content (user info, top posts, subreddit stats, trending subreddits) and creating content (posts, replies to posts, replies to comments) through the Reddit API.
Reddit MCP Server ⚙️
A Model Context Protocol (MCP) that provides tools for fetching and creating Reddit content.
https://github.com/user-attachments/assets/caa37704-7c92-4bf8-b7e8-56d02ccb4983
🧑💻 About
https://www.linkedin.com/feed/update/urn:li:activity:7328864060534419457/
🔧 Available Tools (Features)
Read-only Tools (Client Credentials):
get_user_info(username)- Get detailed user analysis with engagement insightsget_top_posts(subreddit, time_filter, limit)- Get and analyze top postsget_subreddit_stats(subreddit)- Get comprehensive subreddit analysisget_trending_subreddits()- Get list of trending subreddits
Read-write Tools (User Credentials):
create_post(subreddit, title, content, flair, is_self)- Create an optimized postreply_to_post(post_id, content, subreddit)- Add a reply with engagement insightsreply_to_comment(comment_id, content, subreddit)- Add a strategic reply
🔌 Installation
Installing via Smithery
To install Reddit Content Integration Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @alexandros-lekkas/reddit-mcp-server --client claude
Manual Installation
git clone https://github.com/alexandros-lekkas/reddit-mcp-serverCreate a Reddit app here
Make sure to select "script"!
Copy the client ID and client secret
Create a
.envfile based on.env.example
Do this with your REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET
If you want to write posts you need to include your REDDIT_USERNAME and REDDIT_PASSWORD (don't worry, I won't steal them 😜)
Run with
npm run devand open the inspection server (http://127.0.0.1:6274/)
If the connection works, add this to your MCP config (for Cursor or Claude, depending on which agent you are using)
"mcpServers": {
"reddit": {
"command": "node",
"args": [
"C:\\path\\to\\reddit-mcp-server\\build\\index.js" // Replace this with your local path to build/index.js
],
"env": {
"REDDIT_CLIENT_ID": "😜",
"REDDIT_CLIENT_SECRET": "😜",
"REDDIT_USERNAME": "😜",
"REDDIT_PASSWORD": "😜"
},
"autoApprove": [
"get_reddit_post",
"get_top_posts",
"get_user_info",
"get_subreddit_info",
"get_trending_subreddits",
"create_post",
"reply_to_post"
] // You don't need to add this, but it makes it so that you don't have to keep clicking approve
}
}
(Make sure to replace the environmental variables with your actual keys, not the 😜 emoji)
📚 Credits
Credit goes to the Python Reddit MCP Server by Arindam200 for the inspiration and implementation of these tools. This repository is, at the moment, simply a Node.js port of the Python implementation.
Credit goes to Eugene Sh for the tutorial on how to build an MCP server (which was used as a reference for this implementation).
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
reddit-mcp-server
Related MCP Servers
- TypeScriptMIT License
- MIT License
- -securityFlicense-qualityGitHub Repos Manager MCP ServerLast updated -2212