Skip to main content
Glama
reddit-mcp

reddit-mcp

by iris-alights

reddit-mcp

MCP server for Reddit. Read-only mode works out of the box with no setup. Write mode requires a session cookie and comes with risks.

Read-Only Mode (No Setup Required)

Reading from Reddit requires no credentials. Just install and use:

pip install reddit-mcp-noapi

The read tools (reddit_read, reddit_listing, reddit_search) fetch public JSON from old.reddit.com. This is identical to viewing Reddit in a browser — no login required.

Note: Feeding Reddit content to AI probably violates Reddit's ToS. However, read-only access is indistinguishable from normal browsing, so there's no practical risk — Reddit can't tell the difference between you reading a post and Claude reading it.

MCP Config (Read-Only)

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

CLI Examples (Read-Only)

# 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"

Related MCP server: reddit-mcp

⚠️ Read this before proceeding.

Write mode lets you post comments, submit posts, vote, and check your inbox. It works by using session cookies from your browser.

The Risk

This violates Reddit's Terms of Service. Reddit severely restricted API access in 2023 and stopped issuing new free API keys entirely in December 2025. Using automation to bypass their API restrictions is explicitly against their rules.

If Reddit detects automated access on your account, your account may be permanently banned. There's no way to predict if or when this will happen.

If You Accept the Risk

If you're logged into Reddit in your browser, the CLI can import your session automatically:

# Auto-detect browser
reddit auth

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

This extracts the reddit_session cookie and saves it to ~/.config/reddit-mcp/session.json.

Supported browsers:

Browser

Linux

macOS

Windows

Firefox

✓

✓

✓

Chrome

✓

✓

✓

Chromium

✓

✓

✓

Safari

—

?

—

Edge

✓

✓

✓

Opera

✓

✓

✓

Brave

✓

✓

✓

✓ = supported, ? = untested, — = not applicable

Notes:

  • Snap and Flatpak installations of Chrome/Chromium are supported on Linux

  • Chrome-based browsers may prompt for keychain/keyring access to decrypt cookies

  • Safari support is untested — please report if it works (or doesn't)

Using different accounts: If you use different browsers for different Reddit accounts, specify the browser:

# Main account in Firefox
reddit auth --browser firefox

# Alt account in Chromium (use different session directory)
REDDIT_SESSION_DIR=~/.config/reddit-mcp-alt reddit auth --browser chromium

If auto-import doesn't work:

  1. Log into Reddit in your browser

  2. Open DevTools (F12) → Application → Cookies → https://www.reddit.com

  3. Find the cookie named reddit_session

  4. Copy its value (it's a long JWT string starting with eyJ...)

  5. Create ~/.config/reddit-mcp/session.json:

{
  "cookies": {
    "reddit_session": "eyJhbGciOiJS... (your full cookie value here)"
  },
  "username": "your_reddit_username"
}

Note: Manual setup doesn't support auto-refresh. When your cookie expires, you'll need to repeat these steps. Use reddit auth if you want automatic refresh.

(Optional) Override the Session Location

By default, the session is stored in ~/.config/reddit-mcp/. You can override this in your MCP config if you want Claude to use a different Reddit account than your CLI default, or if you're running multiple instances with different accounts:

{
  "mcpServers": {
    "reddit": {
      "command": "reddit-mcp",
      "env": {
        "REDDIT_SESSION_DIR": "/path/to/session/directory"
      }
    }
  }
}

How Write Mode Works

  1. Write operations load the session cookie from ~/.config/reddit-mcp/session.json

  2. The cookie is used to authenticate with old.reddit.com

  3. When the cookie expires, reddit-mcp automatically re-imports from the same browser

Reddit session cookies last a long time (months), so refreshes are rare. If auto-refresh fails (e.g., you logged out of the browser), just run reddit auth again.

Write Tools

Tool

Description

reddit_inbox

Check replies, mentions, messages

reddit_comment

Reply to a post or comment

reddit_submit

Submit a new post

reddit_vote

Upvote/downvote

reddit_delete

Delete your own content

CLI Examples (Write Mode)

# Check inbox
reddit inbox
reddit inbox --unread

# Post a comment (thing_id is t3_xxx for posts, t1_xxx for comments)
reddit comment t3_abc123 "This is my reply"

# Submit a text post
reddit submit LocalLLaMA "Post Title" --text "Post body here"

# Submit a link post
reddit submit LocalLLaMA "Post Title" --url "https://example.com"

# Vote (1 = upvote, -1 = downvote, 0 = remove vote)
reddit vote t3_abc123 1

# Delete your own post or comment
reddit delete t1_xyz789

Why This Exists

Reddit severely restricted third-party API access in 2023 and stopped issuing new free API keys entirely in December 2025. If you want to build something that interacts with Reddit programmatically, your options are:

  1. Be a large company that can negotiate API access

  2. Scrape public pages (read-only)

  3. Use session cookies (what this does for writes)

This tool exists because the AI/LLM community benefits from being able to interact with Reddit, and Reddit has made that impossible through official channels.

License

Unlicense — Public domain. Do whatever you want with it.

The author takes no responsibility for any consequences of using this tool.

Available Tools

8 tools
reddit_commentB

Post a comment reply. Requires authentication.

Inputs: text (required), thing_id (required), check_existing.

reddit_deleteA

Delete your own post or comment. Requires authentication.

Inputs: thing_id (required).

reddit_inboxB

Check Reddit inbox for replies, mentions, and messages. Requires authentication.

Inputs: limit, unread_only.

reddit_listingB

List posts from a subreddit. Returns titles, scores, and permalinks.

Inputs: subreddit (required), skip, sort, limit.

reddit_readA

Read a Reddit post with comments. Returns post content, metadata, and threaded comments.

Inputs: url (required), depth, max_comments.

reddit_submitB

Submit a new post to a subreddit. Requires authentication.

Inputs: title (required), subreddit (required), url, text.

reddit_voteA

Vote on a post or comment. Requires authentication.

Inputs: thing_id (required), direction (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: commenting, deleting, inbox, listing, reading, searching, submitting, and voting. There is no overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent 'reddit_verb' pattern with descriptive verbs, making them predictable and easy to understand.

    Tool Count5/5

    With 8 tools covering essential Reddit actions, the count is well-scoped—not too few to be trivial, not too many to be overwhelming.

    Completeness3/5

    The tools cover create, read, delete, and search functionalities, but lack an edit/update tool for posts or comments, which is a notable gap in the lifecycle.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A dependency-free MCP server that reads Reddit through its RSS feeds, enabling search, browsing subreddits, and reading post comments without any API keys or authentication.
      3
      157 npm
      18
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server that connects to the Reddit Data API to search posts, browse subreddits, read comments, view user profiles, and check trending content through the Model Context Protocol.
      24 npm
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that enables authenticated Reddit account actions like posting, commenting, voting, and messaging via the Reddit API.
      12
      34 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A local, read-only Reddit MCP server that provides tools for searching posts, retrieving posts/comments, subreddit information, and user content via the official Reddit Data API with caching and privacy-focused features.
      -