reddit

This MCP server provides an interface to interact with Reddit via a set of read-only and write tools. You can fetch posts, comments, user information, and subreddit details, or perform write operations such as creating posts, replying, editing, and deleting content, all with built-in safety and policy compliance features. The server exposes functions like get_reddit_post, get_top_posts, get_user_info, get_subreddit_info, search_reddit, create_post, reply_to_post, edit_post, delete_post, and more. You can use these tools through your MCP client or Claude Desktop integration to programmatically query Reddit data or generate content that adheres to Reddit policies and safety safeguards. The server also supports anonymous or authenticated modes and includes options for safe mode, bot disclosure footers, and rate-limiting tiers.

Prerequisites:

• Node.js (LTS recommended) and npm installed on your system
• Basic knowledge of running commands in a shell

Installation steps:

1. Install the MCP server package from npm (global install recommended for CLI access):

npm install -g reddit-mcp-server

2. Run the server directly (using npx or global install):

npx reddit-mcp-server

3. Or add to your MCP config as shown in the example:

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"]
    }
  }
}

4. If you need to specify environment variables, set them in your shell or embed them in your MCP config as shown in the mcp_config example above.

Tips and common considerations:

• Environment variables: set REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD when using authenticated write operations. REDDIT_SAFE_MODE controls write safeguards (off, standard, strict).
• Safe mode defaults to standard to help prevent spammy behavior while writing to Reddit. Adjust via REDDIT_SAFE_MODE as needed.
• Bot disclosure: you can enable automatic bot footers by configuring REDDIT_BOT_DISCLOSURE and REDDIT_BOT_FOOTER for posts, edits, and replies.
• If you’re using Claude Desktop or Cursor, you can point them at the npx command or integrate via your MCP config to streamline usage.
• Ensure you comply with Reddit’s API rules and rate limits; the server provides three-tier auth (10/60/100 rpm) in its policy features to help manage usage.