MCP Directory

How to add Reddit MCP to Windsurf

Gives agents Reddit read/write via PRAW: analyze users and subreddits, search posts, create posts and replies. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Reddit MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Reddit MCP's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Reddit MCP config there under the "mcpServers" key and restart the client.

Is Reddit MCP safe to use with Windsurf?

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.

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