Skip to content

Reddit MCP

A plug-and-play MCP server that enables AI assistants to browse, search, and read Reddit content through the PRAW library.

16
GitHub Stars
MIT
License
WINDOWS, MACOS
Platforms
automate.browser.scrapinganalyze.research.web_summary#environment:network#hosting:remote-capable

Install Reddit MCP in your MCP client

Reddit MCP is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add Reddit MCP to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; Reddit MCP's tools should appear.
{
  "mcpServers": {
    "reddit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@reddit-mcp/mcp-server"
      ],
      "note": "Replace with the actual package name from the server's documentation.",
      "env": {
        "REDDIT_CLIENT_ID": "<your-reddit-client-id>",
        "REDDIT_CLIENT_SECRET": "<your-reddit-client-secret>"
      }
    }
  }
}

Install Reddit MCP in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. Reddit MCP will show up in the assistant's tool list on next launch.

Install Reddit MCP in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). Reddit MCP will show up in the assistant's tool list on next launch.

Install Reddit MCP in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). Reddit MCP will show up in the assistant's tool list on next launch.

Install Reddit MCP in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. Reddit MCP will show up in the assistant's tool list on next launch.

Tools exposed by Reddit MCP

Once installed, Reddit MCP exposes the following MCP tools to your AI assistant. Each tool can be called directly by the assistant whenever its capability is relevant to your prompt.

  • get_comment

    Access a comment

  • get_comments_by_submission

    Access comments of a submission

  • get_submission

    Access a submission

  • get_subreddit

    Access a subreddit by name

  • search_posts

    Search posts in a subreddit

  • search_subreddits

    Search subreddits by name or description

Required environment variables

Reddit MCP needs the following environment variables set before it can run. Add them to the env block of your mcpServers entry, or export them in your shell before launching the client.

  • REDDIT_CLIENT_ID
  • REDDIT_CLIENT_SECRET

Create a developer app in your Reddit account to obtain client_id and client_secret.

Transport

Reddit MCP supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

Platform compatibility

Reddit MCP is reported to run on:

WINDOWSMACOS

Other Model Context Protocol servers in the same space as Reddit MCP. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.