This server provides a Model Context Protocol (MCP) interface for comprehensive Reddit integration, offering both read-only and write capabilities with flexible deployment options.
Core Capabilities:
Fetch Reddit content: Get specific posts, top posts from subreddits (with time filtering), comments with sorting options, and search Reddit with advanced filters
User & subreddit data: Retrieve user profiles, activity, subreddit details, and discover trending subreddits
Content creation (requires user credentials): Create new posts (text/link) and reply to existing posts
Deployment Options:
Traditional MCP server via npx/stdio for Claude Desktop/Cursor
HTTP server with optional OAuth protection for web integration
Docker container deployment with comprehensive Docker Compose support
Security & Configuration:
Requires Reddit API credentials (Client ID/Secret) for read operations
Optional user credentials for write operations
OAuth protection with secure token generation utility
Supports both stdio and HTTP transports for MCP communication
Provides tools for fetching content (posts, comments, user info, subreddit info) from Reddit and creating content (posts, replies) with appropriate credentials.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@reddit-mcp-serverget top posts from r/technology from the past week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Reddit MCP Server
A Model Context Protocol (MCP) server for interacting with Reddit - fetch posts, comments, user info, and create content.
Features at a Glance
Feature | reddit-mcp-server | Other Reddit MCPs |
Create Posts | :white_check_mark: | :x: |
Reply to Posts/Comments | :white_check_mark: | :x: |
Edit Posts/Comments | :white_check_mark: | :x: |
Delete Posts/Comments | :white_check_mark: | :x: |
Spam Protection (Safe Mode) | :white_check_mark: | :x: |
Browse Subreddits | :white_check_mark: | :white_check_mark: |
Search Reddit | :white_check_mark: | :white_check_mark: |
User Analysis | :white_check_mark: | :white_check_mark: |
Post Comments | :white_check_mark: | :white_check_mark: |
Zero-Setup Anonymous Mode | :white_check_mark: | :white_check_mark: |
Three-Tier Auth (10/60/100 rpm) | :white_check_mark: | :white_check_mark: |
Related MCP server: Upstash MCP Server
Quick Start
Option 1: Claude Desktop Extension (Easiest)
Download and open the extension file - Claude Desktop will install it automatically:
Download reddit-mcp-server.mcpb
Option 2: NPX (No install required)
Or add to your MCP config (Claude Desktop, Cursor, etc.):
Option 3: Claude Code
Features
Read-only Tools
Tool | Description |
| Get a specific Reddit post with engagement analysis |
| Get top posts from a subreddit or home feed |
| Get detailed information about a Reddit user |
| Get posts submitted by a specific user |
| Get comments made by a specific user |
| Get subreddit details and statistics |
| Get currently trending subreddits |
| Get comments from a specific post with threading |
| Search for posts across Reddit |
Write Tools (Require User Credentials)
Tool | Description |
| Create a new post in a subreddit |
| Post a reply to an existing post or comment |
| Edit your own Reddit post (self-text only) |
| Edit your own Reddit comment |
| Permanently delete your own post |
| Permanently delete your own comment |
Configuration
Environment Variables
Variable | Required | Default | Description |
| No* | - | Reddit app client ID |
| No* | - | Reddit app client secret |
| No | - | Reddit username (for write operations) |
| No | - | Reddit password (for write operations) |
| No | Auto-generated | Custom User-Agent string |
| No |
| Authentication mode: |
| No |
| Write safeguards: |
*Required only if using authenticated mode.
Full MCP Config Example
Safe Mode (Spam Protection)
New! Protect your Reddit account from spam detection and bans with built-in safeguards.
Why Use Safe Mode?
Reddit's spam detection can flag accounts for:
Rapid posting or commenting
Duplicate or similar content
Non-standard User-Agent strings
Safe Mode helps prevent these issues automatically.
Mode Options
Mode | Write Delay | Duplicate Detection | Use Case |
| None | No | Default, no safeguards |
| 2 seconds | Last 10 items | Recommended for normal use |
| 5 seconds | Last 20 items | For cautious automated posting |
Enable Safe Mode
Or in your MCP config:
What Safe Mode Does
Rate Limiting: Enforces minimum delays between write operations
Duplicate Detection: Blocks identical content from being posted twice
Smart User-Agent: Auto-generates Reddit-compliant User-Agent format when username is provided
Authentication Modes
Mode Comparison
Mode | Rate Limit | Setup Required | Best For |
| ~10 req/min | None | Quick testing, read-only |
| 10-100 req/min | Optional | Flexible usage |
| 60-100 req/min | Required | Production use |
Anonymous Mode (Zero Setup)
Authenticated Mode (Higher Rate Limits)
Create a Reddit app at https://www.reddit.com/prefs/apps (select "script" type)
Copy the client ID and secret
Configure:
Write Operations
To create posts, reply, edit, or delete content, you need user credentials:
Development
Commands
CLI Options
HTTP Server Mode
For Docker deployments or web-based clients, use HTTP transport:
With OAuth Protection
Make authenticated requests:
Docker
Quick Start
Docker Compose
Build Locally
Credits
Fork of reddit-mcp-server by Alexandros Lekkas
Inspired by Python Reddit MCP Server by Arindam200