How to add Reddit MCP to Claude Desktop

Gives agents Reddit read/write via PRAW: analyze users and subreddits, search posts, create posts and replies. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 291★ · stdio · apikey

Claude Desktop config for Reddit MCP

git clone https://github.com/Arindam200/reddit-mcp.git

{
  "mcpServers": {
    "reddit-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-reddit-mcp>",
        "run",
        "server.py"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "<your-client-id>",
        "REDDIT_CLIENT_SECRET": "<your-client-secret>",
        "REDDIT_USERNAME": "<your-username>",
        "REDDIT_PASSWORD": "<your-password>"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Reddit MCP config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Reddit MCP's tools appear under the 🔌 tools menu.

Before you start

uv installed (the config runs `uv --directory ... run server.py`)
A Reddit app of type 'script' created at reddit.com/prefs/apps — gives you the client ID and secret
For write tools only: your Reddit username and password (won't work with 2FA-enabled accounts)

What Reddit MCP can do in Claude Desktop

get_user_info

Detailed user analysis with engagement insights

get_user_comments

A user's comment history with sort and time filters

get_user_posts

A user's post history with sort and time filters

get_top_posts

Top posts from a subreddit for a given time window

search_posts

Search posts across Reddit or within a specific subreddit

get_subreddit_stats

Subreddit statistics and health metrics

get_trending_subreddits

Currently trending subreddits

get_submission_by_url

Fetch a Reddit submission by its URL

Security

Reddit API credentials — and, if you enable writes, your actual Reddit username and password — sit in plain text in the MCP config's env block. Read-only mode needs only client id/secret, so leave the password out unless you want the agent posting; anything it posts is live content under your account and subject to subreddit rules.

Reddit MCP + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Reddit MCP config there under the "mcpServers" key and restart the client.

Is Reddit MCP safe to use with Claude Desktop?

Is reddit-mcp safe and free to use?

Yes — it's MIT-licensed and uses Reddit's free official API via PRAW, no scraping. The main cautions: credentials (including your Reddit password if you enable writes) live in plain text in the config env, and automated posting must respect subreddit rules or you'll get banned by moderators, not by the API.

Do I need my Reddit password?

Only for write operations. Client ID + secret (from a free script app at reddit.com/prefs/apps) unlocks all nine read tools; username and password are needed solely for who_am_i, create_post and the reply tools. Note password auth fails on accounts with 2FA enabled.

Can it post to Reddit automatically?

Yes — with user credentials configured, create_post, reply_to_post and reply_to_comment publish live content under your account. The server adds timing and engagement recommendations, but you're responsible for following each subreddit's self-promotion and bot rules.

View repo Full Reddit MCP page