repository·main·Indexed 41 days ago
https://github.com/jordanburke/reddit-mcp-serverA Model Context Protocol (MCP) server version 1.6.2 that enables AI models to interact with Reddit. It supports read-only operations like searching, browsing, and analyzing, as well as write operations including creating posts, replying, editing, and deleting content. Features include built-in spam protection via Safe Mode, bot disclosure footers for policy compliance, and support for multiple deployment methods including Claude Desktop, NPX, and Docker.
The Reddit MCP Server provides a set of tools for interacting with Reddit. These are categorized into read-only tools (for fetching information) and write tools (for performing actions like posting or replying).
Implemented Tools:
Safe Mode is a built-in safeguard to prevent your Reddit account from being flagged for spam. It is enabled by default in standard mode. It implements:
| 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
```bash
export REDDIT_SAFE_MODE=off
npx reddit-mcp-serverWhen no OAuth credentials are provided, the server uses Reddit's public RSS feeds. This mode is highly restricted:
browse_subreddit and get_top_posts (returns up to 25 posts per request).The server operates in different modes depending on the provided credentials:
| Mode | Rate Limit | Setup Required | Tools Available | Best For |
|---|---|---|---|---|
auto (default) | 60-100 req/min | OAuth credentials | All tools | Most users |
authenticated | 60-100 req/min | OAuth credentials | All tools | Explicit mode |
auto (no creds) | ~1 req/min | None | browse_subreddit, get_top_posts only (RSS) | Quick testing |
anonymous | ~1 req/min | None | browse_subreddit, get_top_posts only (RSS) | Legacy alias |
For Docker deployments or web-based clients, you can use the httpStream transport type.
To run with OAuth protection, enable OAUTH_ENABLED and provide a generated token via the OAUTH_TOKEN environment variable.
# Standard HTTP mode
TRANSPORT_TYPE=httpStream PORT=3000 node dist/index.js
# Authenticated HTTP mode
export OAUTH_ENABLED=true
export OAUTH_TOKEN=$(npx reddit-mcp-server --generate-token | tail -1)
TRANSPORT_TYPE=httpStream node dist/index.jsAs of mid-2026, Reddit requires OAuth credentials for all API access. If you do not provide credentials, the server falls back to an RSS-based mode with significant limitations.
To enable full functionality (including search, user info, and comments), you must provide a REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET. If you need new credentials, you must request access through Reddit's Developer Support.
{
"env": {
"REDDIT_CLIENT_ID": "your_client_id",
"REDDIT_CLIENT_SECRET": "your_client_secret"
}
}You can install the Reddit MCP server using one of three methods depending on your environment:
.mcpb extension file to let Claude Desktop install it automatically.npx and providing your Reddit OAuth credentials.claude mcp add command with environment variables for your credentials.### Option 2: NPX (No install required)
```json
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["reddit-mcp-server"],
"env": {
"REDDIT_CLIENT_ID": "your_client_id",
"REDDIT_CLIENT_SECRET": "your_client_secret"
}
}
}
}REDDIT_CLIENT_ID=your_client_id REDDIT_CLIENT_SECRET=your_client_secret \
claude mcp add --transport stdio reddit -- npx reddit-mcp-serverYou can run the server using a single Docker command or via Docker Compose.
# Pull and run via CLI
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:latestTo comply with Reddit's Responsible Builder Policy, you can enable automatic bot footers. When REDDIT_BOT_DISCLOSURE is set to auto, a footer is appended to all posts, replies, and edits.
To enable the default footer:
export REDDIT_BOT_DISCLOSURE=auto
npx reddit-mcp-serverTo use a custom footer, provide the REDDIT_BOT_FOOTER variable:
export REDDIT_BOT_DISCLOSURE=auto
export REDDIT_BOT_FOOTER=$'\n\n---\n^(🤖 Custom bot footer text)'To perform write operations such as creating posts, replying, editing, or deleting content, you must provide your Reddit username and password in addition to your OAuth credentials. Setting REDDIT_SAFE_MODE to standard is recommended to comply with responsible builder policies.
{
"env": {
"REDDIT_CLIENT_ID": "your_client_id",
"REDDIT_CLIENT_SECRET": "your_client_secret",
"REDDIT_USERNAME": "your_username",
"REDDIT_PASSWORD": "your_password",
"REDDIT_SAFE_MODE": "standard"
}
}Use the following environment variables to configure the server's behavior and authentication:
| Variable | Required | Default | Description |
|---|---|---|---|
REDDIT_CLIENT_ID | Yes | - | Reddit app client ID (OAuth required since mid-2026) |
REDDIT_CLIENT_SECRET | Yes | - | Reddit app client secret |
REDDIT_USERNAME | No | - | Reddit username (for write operations) |
REDDIT_PASSWORD | No | - | Reddit password (for write operations) |
REDDIT_USER_AGENT | No | Auto-generated | Custom User-Agent string |
REDDIT_AUTH_MODE | No | auto | Authentication mode: auto, authenticated (anonymous deprecated) |
REDDIT_SAFE_MODE | No | standard | Write safeguards: off, standard, strict |
REDDIT_BOT_DISCLOSURE | No | off | Bot disclosure footer: auto, off |
REDDIT_BOT_FOOTER | No | Built-in | Custom bot footer text (when disclosure is auto) |
REDDIT_CACHE | No | on | In-memory caching of read requests: on, off |
REDDIT_CACHE_MAX_MB | No | 50 | Cache size cap in MB (LRU eviction beyond this) |
REDDIT_MAX_RETRIES | No | 3 | Retries on HTTP 429 with Retry-After backoff (0 to disable) |