home / mcp / reddit mcp server

Reddit MCP Server

Provides read-only access to Reddit data and optional write actions via session cookies for posting, voting, and inbox checks.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "iris-alights-reddit-mcp": {
      "command": "reddit-mcp",
      "args": [],
      "env": {
        "REDDIT_SESSION_DIR": "path/to/session/dir"
      }
    }
  }
}

You can interact with Reddit data through an MCP server that provides read-only access out of the box and write access when you provide a session cookie. This makes it easy to fetch public posts, listings, and searches, and optionally post or vote if you choose to enable write mode with appropriate credentials.

How to use

To use this MCP server, you typically run the local MCP server and then query it with an MCP client. In read-only mode you can fetch public Reddit data without any login. In write mode you provide a session cookie to perform actions such as posting, commenting, voting, and inbox checks.

How to install

Prerequisites: Python 3.x and pip.

pip install reddit-mcp-noapi

Additional sections

Configuration and usage details are provided here to help you enable read-only access immediately and set up write mode with a session cookie if you choose to proceed.

Read-Only Mode (No Setup Required) lets you read from Reddit without credentials. Install the read-only package, and use the read tools to fetch public JSON from old.reddit.com without logging in.

Read-Only MCP Config (example) shows how to expose the Reddit read tools via MCP. The following configuration maps the Reddit MCP server name to the command that starts the MCP server.

{
  "mcpServers": {
    "reddit": {
      "command": "reddit-mcp"
    }
  }
}

Notes on write mode and safety

Write mode lets you post, submit, vote, and check your inbox using a session cookie from your browser. Using write mode carries potential risks because it acts on your real Reddit account.

If you choose to proceed, you can import your session automatically from your browser or export a cookie manually.

Option 1: Auto-Import from Browser (recommended) lets the CLI detect your browser session and save it for use by the MCP server.

# Auto-detect browser
reddit auth

# Or specify a browser
reddit auth --browser firefox
reddit auth --browser chrome

Write Tools

The following tools are available for write mode interactions:

- reddit_inbox: Check replies, mentions, messages - reddit_comment: Reply to a post or comment - reddit_submit: Submit a new post - reddit_vote: Upvote or downvote - reddit_delete: Delete your own content

CLI examples for read-only use

# Read a post with comments
reddit read https://reddit.com/r/LocalLLaMA/comments/abc123/post_title

# List subreddit posts
reddit listing LocalLLaMA --limit 10

# Search
reddit search LocalLLaMA "llama 3"

Available tools

reddit_read

Fetch public Reddit posts and comments from old.reddit.com without login.

reddit_listing

Retrieve a list of posts from a subreddit in JSON format.

reddit_search

Search Reddit posts and return results in JSON.

reddit_inbox

Check replies, mentions, messages for your Reddit account in write mode.

reddit_comment

Post a reply to a post or comment.

reddit_submit

Submit a new post, either text or link.

reddit_vote

Upvote or downvote a post or comment.

reddit_delete

Delete your own post or comment.