Reddit

You can run a Reddit MCP Server to interact with Reddit programmatically, including reading posts and comments and performing write actions like creating or editing content, all with built-in safety and policy features.

How to use

You will connect to the Reddit MCP Server through an MCP client, sending read and write commands to manage posts, comments, and user data. Use the read tools to fetch information and trends, and switch to the write tools only when you have authenticated access and the appropriate safeguards configured. Turn on safety features to prevent spam and ensure disclosure where required.

How to install

Prerequisites: you need Node.js and npm or pnpm installed on your machine. You will run the MCP server via an executable command or a package runner like npx.

# Install dependencies is handled by the runtime tool when using npx
# Start the MCP server using NPX
npx reddit-mcp-server

Configuration and usage notes

To customize how the server authenticates and writes to Reddit, you can provide environment variables. You can place these in an environment file or export them in your session before starting the server.

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"],
      "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"
      }
    }
  }
}

Additional sections

Enable safe and compliant operation by configuring safe mode, bot disclosures, and authentication modes as described in the sections below. The server supports read-only and write modes, with write actions gated behind user credentials.

Available tools

get_reddit_post

Fetch a specific Reddit post and analyze engagement metrics.

get_top_posts

Retrieve top posts from a subreddit or the home feed.

get_user_info

Get detailed information about a Reddit user.

get_user_posts

List posts submitted by a specific user.

get_user_comments

List comments made by a specific user.

get_subreddit_info

Get subreddit details and statistics.

get_trending_subreddits

List currently trending subreddits.

get_post_comments

Fetch comments from a specific post with threading.

search_reddit

Search posts across Reddit.

create_post

Create a new post in a subreddit (write operation).

reply_to_post

Post a reply to an existing post or comment (write operation).

edit_post

Edit your own Reddit post (self-text only).

edit_comment

Edit your own Reddit comment.

delete_post

Permanently delete your own post.

delete_comment

Permanently delete your own comment.