reddit-mcp-server — Claude Code MCP server: how to install
Lets an agent read Reddit, search it, and publish posts or replies from your account. Needs Reddit OAuth credentials.
MIT ★ 343 updated 2026-10-17
claude mcp add --env REDDIT_CLIENT_ID=<REDDIT_CLIENT_ID> --env REDDIT_CLIENT_SECRET=<REDDIT_CLIENT_SECRET> --env REDDIT_USERNAME=<REDDIT_USERNAME> --env REDDIT_PASSWORD=<REDDIT_PASSWORD> --env REDDIT_AUTH_MODE=<REDDIT_AUTH_MODE> --transport stdio reddit-mcp-server -- npx -y reddit-mcp-serverWhat reddit-mcp-server does
The server connects an agent to Reddit over OAuth. On the reading side it returns posts, comment threads, user profiles, subreddit details and trending subreddits, and search_reddit queries the whole site. browse_subreddit pages through a feed in the sort order you pick.
Eight write tools let the agent post, reply, edit, save and delete. Deletions can't be undone. Spam protection is controlled by REDDIT_SAFE_MODE, which defaults to standard and also accepts off and strict. The footer that marks text as bot-written stays off until you set REDDIT_BOT_DISCLOSURE=auto.
REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are mandatory, and writing also requires REDDIT_USERNAME and REDDIT_PASSWORD. Reddit stopped letting people create apps on their own in November 2025, so get your keys before you start. The server runs through npx. Reads are cached in memory up to 50 MB, and after an HTTP 429 response it retries up to 3 times.
What it helps with
- search Reddit for threads about your library or error message
- summarize a long comment thread under a post
- check what a specific user has posted and commented
- publish a post to a subreddit without leaving the agent chat
- delete an outdated post or comment of your own
Example prompts for the agent
- Use
search_redditto find threads about Vite build errors and show the most active ones - Pull the comments for this post with
get_post_commentsand summarize what people disagree on - Answer this comment with
reply_to_postusing the text I paste below
How to install reddit-mcp-server
Platform CLI
claude mcp add --env REDDIT_CLIENT_ID=<REDDIT_CLIENT_ID> --env REDDIT_CLIENT_SECRET=<REDDIT_CLIENT_SECRET> --env REDDIT_USERNAME=<REDDIT_USERNAME> --env REDDIT_PASSWORD=<REDDIT_PASSWORD> --env REDDIT_AUTH_MODE=<REDDIT_AUTH_MODE> --transport stdio reddit-mcp-server -- npx -y reddit-mcp-serverReplace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
codex mcp add reddit-mcp-server --env REDDIT_CLIENT_ID=<REDDIT_CLIENT_ID> --env REDDIT_CLIENT_SECRET=<REDDIT_CLIENT_SECRET> --env REDDIT_USERNAME=<REDDIT_USERNAME> --env REDDIT_PASSWORD=<REDDIT_PASSWORD> --env REDDIT_AUTH_MODE=<REDDIT_AUTH_MODE> -- npx -y reddit-mcp-serverReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"mcpServers": {
"reddit-mcp-server": {
"command": "npx",
"args": [
"-y",
"reddit-mcp-server"
],
"env": {
"REDDIT_CLIENT_ID": "<REDDIT_CLIENT_ID>",
"REDDIT_CLIENT_SECRET": "<REDDIT_CLIENT_SECRET>",
"REDDIT_USERNAME": "<REDDIT_USERNAME>",
"REDDIT_PASSWORD": "<REDDIT_PASSWORD>",
"REDDIT_AUTH_MODE": "<REDDIT_AUTH_MODE>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"servers": {
"reddit-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"reddit-mcp-server"
],
"env": {
"REDDIT_CLIENT_ID": "<REDDIT_CLIENT_ID>",
"REDDIT_CLIENT_SECRET": "<REDDIT_CLIENT_SECRET>",
"REDDIT_USERNAME": "<REDDIT_USERNAME>",
"REDDIT_PASSWORD": "<REDDIT_PASSWORD>",
"REDDIT_AUTH_MODE": "<REDDIT_AUTH_MODE>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
gemini mcp add -e REDDIT_CLIENT_ID=<REDDIT_CLIENT_ID> -e REDDIT_CLIENT_SECRET=<REDDIT_CLIENT_SECRET> -e REDDIT_USERNAME=<REDDIT_USERNAME> -e REDDIT_PASSWORD=<REDDIT_PASSWORD> -e REDDIT_AUTH_MODE=<REDDIT_AUTH_MODE> reddit-mcp-server npx -y reddit-mcp-serverReplace <…> with your own values. 3 more environment variables are in the server README
Step 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-server
How do I install reddit-mcp-server in Claude Code?
Run `claude mcp add --env REDDIT_CLIENT_ID=<REDDIT_CLIENT_ID> --env REDDIT_CLIENT_SECRET=<REDDIT_CLIENT_SECRET> --env REDDIT_USERNAME=<REDDIT_USERNAME> --env REDDIT_PASSWORD=<REDDIT_PASSWORD> --env REDDIT_AUTH_MODE=<REDDIT_AUTH_MODE> --transport stdio reddit-mcp-server -- npx -y reddit-mcp-server`, replacing the placeholders with your own values.
What does reddit-mcp-server do?
It lets an agent read posts, comments and user profiles, search Reddit and inspect subreddits. With user credentials it can also create posts and replies, edit them, save them and delete them.
Which credentials does reddit-mcp-server need?
REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are required. To publish, edit or delete, also set REDDIT_USERNAME and REDDIT_PASSWORD.