What is Reddit Mcp Server

reddit-mcp-server is a Model Context Protocol (MCP) designed to provide tools for fetching and creating content from Reddit.

Use cases

Use cases include analyzing user engagement, generating content for specific subreddits, monitoring trending topics, and enhancing interaction through strategic replies.

How to use

To use reddit-mcp-server, clone the repository from GitHub, create a Reddit app to obtain client credentials, set up a .env file with your credentials, and run the server using npm.

Key features

Key features include read-only tools for user analysis, top posts retrieval, subreddit statistics, and trending subreddits, as well as read-write tools for creating posts and replying to comments.

Where to use

reddit-mcp-server can be used in social media management, content creation, data analysis, and community engagement within the Reddit platform.

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 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

Make sure to select “script”!

3. Copy the client ID and client secret

4. 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 😜)

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

6. If the connection works, add this to your MCP config (for Cursor or Claude, depending on which agent you are using)

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