A Model Context Protocol (MCP) server for interacting with Reddit. It supports full read/write operations, including fetching posts, comments, and user information, performing search, and creating content. The server is identified by the package slug io-github-jordanburke-reddit-mcp-server.
๐ ๏ธ Key Features
Full read/write for Reddit data
Posts and comments retrieval
User info access
Search
Content creation
๐ Use Cases
Fetching Reddit posts and comments
Retrieving user information
Searching Reddit content
Creating Reddit content programmatically
โก Developer Benefits
Centralized MCP interface for Reddit interactions
Includes both read operations (posts, comments, user info, search) and write operations (content creation)
โ ๏ธ Limitations
Limited to Reddit interactions as described (no other platforms are mentioned)
Reddit announced on 2026-09-30 that it is ending RSS feeds and its public Data API, and moving apps to its Developer Platform (r/redditdev post, r/modnews post):
Date
What Reddit does
2026-10-31
Stops accepting new requests for public API access
2026-11-13
Stops supporting RSS feeds
2027-01-12
Starts removing API access for apps and users that haven't registered or responded to Reddit's outreach
March 2027
Closes public API access for all remaining apps and users
What this server uses to keep working
The server reads from three sources and uses the best one you have:
Source
Needs
Used for
Lasts until
Reddit's API (OAuth)
REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET
Every tool, with live data (writes also need username and password)
March 2027, per Reddit
Reddit's RSS feeds
Nothing
Ranked listings (hot, top, rising, controversial) and the home feed, without credentials
No announced end. It's free, run by one volunteer, has no uptime guarantee, and gets its data from Reddit's API
Arctic Shift is a third-party copy of Reddit, not Reddit's API, though it collects its data through Reddit's API. Its scores and comment counts lag, and every result from it says so. See Keyless Mode for what each tool can do without credentials.
What it means for you
You have OAuth credentials: every read tool works. Write tools also need REDDIT_USERNAME and REDDIT_PASSWORD. Register your app at developers.reddit.com/app-registration before 2027-01-12, or Reddit may remove its access early.
You don't have credentials: most read tools work with no setup. Reddit no longer accepts new API access requests, so new users run in keyless mode.
After 2026-11-13: without credentials, ranked listings for a single subreddit fall back to the archive's newest posts, because RSS is gone. The home feed and multireddits have no keyless source after that date.
After March 2027: Reddit says public API access closes, and that is the path the OAuth tools use, so the write tools and the OAuth-only reads stop working. Arctic Shift says it collects all its data through Reddit's API, so the archive may stop getting new posts then. Keyless reads would still return what it already holds.
Features at a Glance
Feature
reddit-mcp-server
Other Reddit MCPs
Create Posts
โ
โ
Reply to Posts/Comments
โ
โ
Edit Posts/Comments
โ
โ
Delete Posts/Comments
โ
โ
Spam Protection (Safe Mode)
โ
โ
Bot Disclosure Footer
โ
โ
Policy Compliance Built-in
โ
โ
Browse Subreddits
โ
โ
Search Reddit
โ
โ
User Analysis
โ
โ
Post Comments
โ
โ
OAuth Auth (60-100 rpm)
โ
โ
Keyless mode (zero-setup)
โ
โ
Quick Start
Option 1: Claude Desktop Extension (Easiest)
Download and open the extension file - Claude Desktop will install it automatically:
Add to your MCP config (Claude Desktop, Cursor, etc.). Credentials are optional: without them the server runs in keyless mode, and with them you get live data and every tool.
Get a specific Reddit post with engagement analysis
get_top_posts
Get top posts from a subreddit or home feed
browse_subreddit
Browse a subreddit/home feed by sort (hot, new, top, rising, controversial)
get_post_comments
Get comments from a specific post with threading
get_more_comments
Expand collapsed comments in a thread
get_user_info
Get detailed information about a Reddit user
get_user_posts
Get posts submitted by a specific user
get_user_comments
Get comments made by a specific user
get_subreddit_info
Get subreddit details and statistics
get_subreddit_rules
Get a subreddit's posting rules
search_reddit
Search for posts, subreddits, or users
get_trending_subreddits
Get currently trending subreddits (needs OAuth)
get_post_flairs
List a subreddit's available post flairs (needs OAuth)
get_me
Get your own account info (needs OAuth and user credentials)
get_my_overview
Get your own recent posts and comments (needs OAuth and user credentials)
get_my_saved
Get your saved posts and comments (needs OAuth and user credentials)
test_reddit_mcp_server
Check server status and configuration
Most read tools also work without credentials. See Keyless Mode for each tool's limits.
Write Tools (Require User Credentials)
Write tools need Reddit's API, so they need OAuth credentials plus REDDIT_USERNAME and REDDIT_PASSWORD. Reddit closes its public API in March 2027 (details).
Protect your Reddit account from spam detection and bans with built-in safeguards. Enabled by default (standard mode) per Reddit's Responsible Builder Policy.
Why Use Safe Mode?
Reddit's spam detection can flag accounts for:
Rapid posting or commenting
Duplicate or similar content
Posting the same content across multiple subreddits
Non-standard User-Agent strings
Safe Mode helps prevent these issues automatically.
Mode Options
Mode
Write Delay
Duplicate Detection
Use Case
off
None
No
Explicit opt-out only
standard
2 seconds
Last 10 items + cross-sub
Default, recommended
strict
5 seconds
Last 20 items + cross-sub
For cautious automated posting
Disable Safe Mode
Safe mode is enabled by default. To explicitly disable:
bash
export REDDIT_SAFE_MODE=off
npx reddit-mcp-server
What Safe Mode Does
Rate Limiting: Enforces minimum delays between write operations
Duplicate Detection: Blocks identical content from being posted twice
Cross-Subreddit Detection: Prevents posting the same content to multiple subreddits (per Reddit policy)
Smart User-Agent: Auto-generates Reddit-compliant User-Agent format when username is provided
Bot Disclosure
Reddit's Responsible Builder Policy requires bots to disclose their automated nature. Enable automatic bot footers on all posted content:
Reddit's unauthenticated API no longer works. As of mid-2026, Reddit blocks unauthenticated API requests with HTTP 403, so reading Reddit's API needs OAuth credentials. REDDIT_AUTH_MODE=anonymous still exists, but it is now an alias for keyless mode.
Reddit closed self-service OAuth app creation in November 2025, and as of 2026-10-31 it accepts no new requests for public API access. Existing OAuth credentials keep working until March 2027 if the app is registered by 2027-01-12. Reddit starts removing access for unregistered apps on that date.
Getting Credentials
If you already have a Reddit app (created at /prefs/apps before November 2025, or approved through Reddit's Developer Support): use your existing client ID and secret. They still work at 60-100 req/min. Register the app at developers.reddit.com/app-registration before 2027-01-12.
If you don't have credentials: Reddit no longer accepts new requests for public API access, so use keyless mode.
If Reddit rejects your credentials at startup, auto logs a warning and starts anyway, and each tool call reports the error. authenticated exits instead.
Keyless Mode
Without OAuth credentials, reads come from two free sources:
Reddit's RSS feeds for ranked listings (hot, top, rising, controversial, and the home feed). Reddit retires RSS on 2026-11-13. When a feed fails for a named subreddit, the server falls back to the archive's newest posts and says ranking is unavailable.
The Arctic Shift archive, a free third-party copy of Reddit run by one volunteer. It is not Reddit's API and has no uptime guarantee.
Tool
Keyless source
Limits
browse_subreddit (new)
Arctic Shift
One subreddit; no multireddits
browse_subreddit (other), get_top_posts
RSS, then Arctic Shift
Archive fallback is newest-first, not ranked
get_reddit_post
Arctic Shift
get_post_comments
Arctic Shift
Recent comments may be missing; no sort
get_more_comments
Arctic Shift
get_user_info
Arctic Shift
Account age estimated from first activity; status flags unknown
get_user_posts, get_user_comments
Arctic Shift
Newest first only
get_subreddit_info, get_subreddit_rules
Arctic Shift
search_reddit
Arctic Shift
Posts need subreddit; type=sr matches name prefixes; no type=user
Archive caveats: scores and comment counts lag, and are often 0 or 1 on recent posts. Keyword search on large subreddits is slow, and the archive throttles it. The server waits up to 10 seconds and retries once. If that fails too, the error says when to retry. Every archive result ends with a note naming the source.
Still needs OAuth:get_trending_subreddits, get_post_flairs, get_me, get_my_overview, get_my_saved, search_reddit with type=user, and all write tools.
pnpm install # Install dependencies
pnpm build # Build TypeScript
pnpm dev # Rebuild on every change
pnpm inspect # Build and open the MCP inspector
pnpm validate # Format, lint, typecheck, test and build
pnpm test# Run tests
pnpm lint # Lint code
pnpm format # Format code
CLI Options
bash
npx reddit-mcp-server --version # Show version
npx reddit-mcp-server --help# Show help
HTTP Server Mode
For Docker deployments or web-based clients, use HTTP transport:
A request with no token gets 401, and a wrong token gets 403.
Docker
Quick Start
bash
# Pull and run
docker pull ghcr.io/jordanburke/reddit-mcp-server:latest
docker run -d \
--name reddit-mcp \
-p 3000:3000 \
-e REDDIT_CLIENT_ID=your_client_id \
-e REDDIT_CLIENT_SECRET=your_client_secret \
-e REDDIT_SAFE_MODE=standard \
ghcr.io/jordanburke/reddit-mcp-server:latest
Leave out the two credential variables to run the container keyless.
Docker Compose
yaml
services:reddit-mcp:image:ghcr.io/jordanburke/reddit-mcp-server:latestports:-"3000:3000"environment:-REDDIT_CLIENT_ID=${REDDIT_CLIENT_ID}-REDDIT_CLIENT_SECRET=${REDDIT_CLIENT_SECRET}-REDDIT_USERNAME=${REDDIT_USERNAME}-REDDIT_PASSWORD=${REDDIT_PASSWORD}-REDDIT_SAFE_MODE=standard-OAUTH_ENABLED=${OAUTH_ENABLED:-false}# Unset or empty: the server generates a token and prints it at startup-OAUTH_TOKEN=${OAUTH_TOKEN}restart:unless-stopped