reddit-mcp-buddy — Claude Code MCP server: Reddit without API keys
An MCP server that lets your AI assistant read Reddit: browse subreddits, search posts, pull comment threads and user profiles. No keys needed for browsing.
claude mcp add reddit-mcp-buddy -- npx -y reddit-mcp-buddyWhat reddit-mcp-buddy does
The server connects over stdio and exposes five tools. browse_subreddit lists posts with hot, new, top, rising and controversial sorting, search_reddit searches all of Reddit or one subreddit with filters for author, time and flair, get_post_details returns a post with its full comment tree, user_analysis collects karma, posts and active subreddits, and reddit_explain covers terms like karma or AMA.
Without credentials, results come from Reddit's public RSS feed: score, num_comments, upvote_ratio and nsfw come back empty, and the include_nsfw filter cannot be applied. Search, comments, user analysis and metrics need free Reddit credentials — register an app at reddit.com/prefs/apps, pick the script type, then set REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET in the environment. Worth doing up front if you want numbers rather than headlines.
It is written in TypeScript and runs through npx, so nothing gets installed globally. There are three access tiers with different request limits; the project's table has the exact numbers. For get_post_details, pass the post ID together with the subreddit — that saves one API call.
What it helps with
- check what a subreddit says about a library or a device
- pull a full comment thread instead of the first few replies
- look up a user's karma and posting history
- find discussions by keyword within a time window
- explain Reddit slang like cake day or ELI5 to the assistant
Example prompts for the agent
- What's trending on r/programming this week?
- Search r/rust for posts from the last month and show comments on the busiest one
- Analyze user spez: karma, posts, active subreddits
How to install reddit-mcp-buddy
Platform CLI
claude mcp add reddit-mcp-buddy -- npx -y reddit-mcp-buddyPlatform CLI
codex mcp add reddit-mcp-buddy -- npx -y reddit-mcp-buddyConfig file
{
"mcpServers": {
"reddit-mcp-buddy": {
"command": "npx",
"args": [
"-y",
"reddit-mcp-buddy"
]
}
}
}Config file
{
"servers": {
"reddit-mcp-buddy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"reddit-mcp-buddy"
]
}
}
}Platform CLI
gemini mcp add reddit-mcp-buddy npx -y reddit-mcp-buddyStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about reddit-mcp-buddy
How do I install reddit-mcp-buddy in Claude?
Run claude mcp add reddit-mcp-buddy -- npx -y reddit-mcp-buddy. That registers the server, and the assistant picks up its tools.
What does reddit-mcp-buddy do?
It gives your assistant access to Reddit: browse subreddits, search posts, read comments, analyze user profiles and explain Reddit terminology.
Do I need Reddit API keys?
Not for browsing subreddits. Search, comments, user analysis and metrics only work with free credentials; otherwise data comes from RSS without score or comment counts.
