Reddit MCP Server – README | MCP Marketplace

✨ From vibe coding to vibe deployment. UBOS MCP turns ideas into infra with one message.

Learn more

Reddit MCP Server ⚙️

A Model Context Protocol (MCP) that provides tools for fetching and creating Reddit content.

smithery badge

https://github.com/user-attachments/assets/caa37704-7c92-4bf8-b7e8-56d02ccb4983

🧑‍💻 About

https://www.linkedin.com/feed/update/urn:li:activity:7328864060534419457/

image

🔧 Available Tools (Features)

Read-only Tools (Client Credentials):

  • get_user_info(username) - Get detailed user analysis with engagement insights
  • get_top_posts(subreddit, time_filter, limit) - Get and analyze top posts
  • get_subreddit_stats(subreddit) - Get comprehensive subreddit analysis
  • get_trending_subreddits() - Get list of trending subreddits

Read-write Tools (User Credentials):

  • 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

🔌 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

  1. git clone https://github.com/alexandros-lekkas/reddit-mcp-server

  2. Create a Reddit app here

image

Make sure to select “script”!

  1. Copy the client ID and client secret

  2. Create a .env file 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 😜)

  1. Run with npm run dev and open the inspection server (http://127.0.0.1:6274/)

image

  1. 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).

Featured Templates

View More
AI Assistants
AI Chatbot Starter Kit v0.1
130 667
Verified Icon
AI Agents
AI Chatbot Starter Kit
1308 6081 5.0
AI Agents
AI Video Generator
249 1348 5.0
Customer service
Multi-language AI Translator
135 646

Start your free trial

Build your solution today. No credit card required.

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.