Log inSubmit server
Reddit MCP Server logo

Reddit MCP Server

Reads Reddit content and supports guarded posting, replies, editing, saving, and deletion through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Reddit MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "reddit-mcp-server-2": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-mcp-server"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "YOUR_VALUE_HERE",
        "REDDIT_CLIENT_SECRET": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y reddit-mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 7d ago.

Overview

The reddit-mcp-server MCP server exposes Reddit reading and content-management operations through the Model Context Protocol. It provides tools for posts, comments, subreddits, users, search, and authenticated write actions such as creating, replying, editing, saving, and deleting content. OAuth credentials enable Reddit API access, while RSS fallback supports zero-setup read access. Use it when an MCP client needs Reddit research, account analysis, or controlled posting workflows.

Use cases

  • Browse subreddit feeds and discussions
  • Search Reddit posts for research
  • Analyze a user’s posts and comments
  • Create and reply to Reddit content
  • Moderate your own saved and published content

Key features

  • Read posts, comments, users, and subreddits
  • Search Reddit and browse sorted feeds
  • Create posts and replies
  • Edit, save, unsave, and delete content
  • Safe Mode with delays and duplicate checks
  • OAuth access with RSS read fallback

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · reddit-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars297Stargazers on the source repository.
npm downloads4.7kPackage downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Reddit MCP Server works

What the reddit-mcp-server MCP server does

The reddit-mcp-server MCP server connects MCP-compatible clients to Reddit for both read and write workflows. Read operations cover individual posts, subreddit feeds, subreddit details, users, user activity, post comments, trending subreddits, and Reddit-wide search. Some post results also include engagement analysis, and comment retrieval preserves thread structure.

Write operations require user credentials. Available actions include creating a subreddit post, replying to a post or comment, editing a self-text post, editing a comment, saving or unsaving content, and permanently deleting the user’s own posts or comments. The server does not describe editing a post title or other fields beyond self-text.

How it works

The server runs as an MCP process and can be launched with npx reddit-mcp-server. MCP clients send tool calls to the process, which accesses Reddit using the configured authentication settings. The README provides configurations for Claude Desktop and Cursor, plus a stdio command for Claude Code.

OAuth is the primary authentication path. The server accepts a Reddit client ID and client secret, with username and password available for write operations. Its authentication mode can be set to auto or authenticated; anonymous mode is deprecated. Read requests can use an RSS fallback described as zero-setup, while API-based access uses the Reddit credentials configured for the process.

Setup and configuration

Set REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET before starting the reddit-mcp-server MCP server. REDDIT_USERNAME and REDDIT_PASSWORD are needed for operations performed on a Reddit account. REDDIT_USER_AGENT can override the automatically generated user agent.

Write safeguards are controlled with REDDIT_SAFE_MODE. The default standard mode inserts a two-second delay between writes and checks recent and cross-subreddit content for duplicates. strict uses a five-second delay and checks a larger recent history; off disables those safeguards. REDDIT_BOT_DISCLOSURE can add an automatic bot footer, and REDDIT_BOT_FOOTER supplies custom footer text.

Read caching is enabled by default in memory. Set REDDIT_CACHE to off to disable it, or adjust REDDIT_CACHE_MAX_MB from its default 50 MB limit. REDDIT_MAX_RETRIES controls retries after HTTP 429 responses and defaults to three.

Tools and capabilities

Read-only tools include:

  • get_reddit_post for a specific post and engagement analysis
  • get_top_posts and browse_subreddit for feeds and subreddit sorting
  • get_user_info, get_user_posts, and get_user_comments for account activity
  • get_subreddit_info and get_trending_subreddits for subreddit discovery
  • get_post_comments for threaded discussion retrieval
  • search_reddit for searching posts across Reddit

Write tools cover posting, replies, edits, saves, unsaves, and deletion. Safe Mode adds delays, duplicate checks, cross-subreddit checks, and a generated Reddit-compliant user agent when a username is available.

Limitations and notes

The reddit-mcp-server MCP server requires a Reddit client ID and secret according to the documented configuration. Write tools additionally require account credentials and act on the authenticated user’s content where applicable. Deletion is permanent for the user’s own posts or comments. Safe Mode is enabled by default, but can be explicitly disabled through configuration. Reddit app creation and OAuth requirements may affect how credentials are obtained.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Reddit MCP Server

reddit-mcp-server is an MCP server that connects AI clients to Reddit. Its main tools retrieve posts, comments, users, subreddits, feeds, and search results, while authenticated tools create posts, reply, edit, save, unsave, and delete the user’s own Reddit content.

Install it through the downloadable Claude Desktop extension or run it with `npx reddit-mcp-server`. Add the process to an MCP client configuration and provide `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET`; username and password are needed for write operations.

Yes, the documented NPX configuration supports Cursor. Define an MCP server that runs `npx reddit-mcp-server`, then add the Reddit client ID and client secret as environment variables.

Safe Mode is enabled by default with `REDDIT_SAFE_MODE=standard`. Use `strict` for longer delays and broader duplicate checks, or set `off` only when explicitly opting out. The safeguards apply delays and duplicate or cross-subreddit checks to write operations.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewReddit MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/reddit-mcp-server-2?style=directory)](https://allmcps.com/mcp/reddit-mcp-server-2)
HTML Embed
<a href="https://allmcps.com/mcp/reddit-mcp-server-2"><img src="https://allmcps.com/api/badge/reddit-mcp-server-2?style=directory" alt="Reddit MCP Server on AllMCPs" /></a>