reddit-mcp

A read-only MCP server built for Claude that connects to the Reddit Data API (oauth.reddit.com). Search posts, browse subreddits, read comments, view user profiles, and check trending content — all through the Model Context Protocol.

npx -y @hamzashahbaz/reddit-mcp

Or add it to Claude Code with environment variables:

claude mcp add reddit -e REDDIT_CLIENT_ID=your_id -e REDDIT_CLIENT_SECRET=your_secret -e REDDIT_USERNAME=your_username -e REDDIT_PASSWORD=your_password -- npx -y @hamzashahbaz/reddit-mcp

• Search Reddit -- query posts across all of Reddit or within a specific subreddit
• Browse subreddits -- get posts sorted by hot, new, top, or rising
• Read comments -- fetch a post's details and top-level comments
• User profiles -- view profile info and recent activity (posts, comments, or both)
• Trending posts -- see what's popular on r/popular

• Node.js 18+
• A Reddit account
• A Reddit "script" application (free) -- see Setup

Reddit requires API access approval before you can create apps.

1. Go to Reddit Help — Submit a request
2. Select API Access Request
3. Fill in the form:

• Benefit/purpose: Read-only content browsing tool that helps users discover and read Reddit content through AI assistants — no posting, commenting, or voting.
• Detailed description: reddit-mcp is an open-source MCP (Model Context Protocol) server that provides read-only access to Reddit's public content. It allows AI assistants to search posts, browse subreddits, read comments, and view user profiles. All operations are read-only GET requests. Source code: https://github.com/hamzashahbaz/reddit-mcp
• Devvit question: This tool is an external read-only client that integrates Reddit content into