Reddit MCP Server

MCP server that lets Claude (and other MCP clients) scan, search, and read Reddit posts and comments.

Tools

Tool	Description
scan_subreddit	Fetch posts from a subreddit by sort order (hot/top/new/rising) with optional comments
search_posts	Search Reddit posts by keyword across one or all subreddits
get_post_details	Get full details and comments for a specific post
find_subreddits	Find subreddits by topic keyword
get_subreddit_info	Get metadata for a subreddit

Setup

npm install
npm run build

Requires Node.js 18 or newer.

The server uses Reddit's public JSON endpoints and does not require Reddit API credentials.

Claude Desktop Configuration

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

{
  "mcpServers": {
    "reddit": {
      "command": "node",
      "args": ["/absolute/path/to/reddit-mcp/dist/server.js"]
    }
  }
}

Replace the example path with the path where you cloned this repository.

VS Code MCP Configuration

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "reddit": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/server.js"]
    }
  }
}

When configuring this outside the repository workspace, replace ${workspaceFolder} with the absolute path to the cloned repository.

Usage Examples

Once connected, Claude can use these tools:

• Scan a subreddit: "Show me the top 20 posts from r/programming this week"
• Search posts: "Search Reddit for 'MCP server tutorial'"
• Get post details: "Get the comments on that first post"

Architecture

• src/server.ts — MCP server entry, tool registration, stdio transport
• src/tools/ — Individual tool handlers with input validation
• src/reddit/ — Reddit data client with provider abstraction
• src/reddit/providers/publicJson.ts — Public JSON endpoint provider (MVP)
• src/core/ — Shared types, validation, and error taxonomy
• src/tests/ — Unit tests for caching and comment deduplication

The provider interface (RedditProvider) makes it easy to swap to Reddit OAuth API later without changing any tool code.