reddit-connector-mcp

A Model Context Protocol (MCP) server that lets AI assistants browse Reddit. Search posts, read comments, and view user profiles — no API key required.

Features

• Search Reddit — search across all of Reddit or within a specific subreddit
• Browse Subreddits — get posts sorted by hot, new, top, or rising
• Read Comments — fetch full comment threads with nested replies
• User Profiles — view karma, account age, and recent activity
• No API Key Required — uses Reddit's public JSON API
• Dual Output — supports both JSON and Markdown response formats
• Resilient — automatic retry with exponential backoff on rate limits

Quick Start

Claude Code (CLI)

claude mcp add reddit -- npx -y reddit-connector-mcp

Claude Desktop

Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "reddit-connector-mcp"]
    }
  }
}

Cursor / Windsurf / Other MCP Clients

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "reddit-connector-mcp"]
    }
  }
}

Install Globally (Optional)

npm install -g reddit-connector-mcp

Tools

All tools support a response_format parameter (json or markdown).

Examples

Search posts:

{ "query": "machine learning", "subreddit": "programming", "limit": 10 }

Get subreddit posts:

{ "subreddit": "science", "sort": "top", "limit": 5 }

Get post comments:

{ "post_url": "https://www.reddit.com/r/programming/comments/abc123/my_post/" }

Get user profile:

{ "username": "spez" }

Get user posts:

{ "username": "spez", "limit": 10 }

How It Works

This server uses Reddit's public .json endpoints (e.g., reddit.com/r/programming.json), which don't require authentication. This means:

• Zero configuration — no OAuth, no API keys, no Reddit account needed
• Rate limited — ~60 requests/minute (Reddit's unauthenticated limit)
• Read-only — browse and search, no posting or voting
• Automatic retry — exponential backoff on 429/5xx errors (up to 3 retries)
• Token-efficient — text truncated to minimize token usage (25KB max response)

Development

git clone https://github.com/ShellyDeng08/reddit-connector-mcp.git
cd reddit-connector-mcp
npm install
npm run build
npm start

License

MIT