Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What 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_reddit to find threads about Vite build errors and show the most active ones
  • Pull the comments for this post with get_post_comments and summarize what people disagree on
  • Answer this comment with reply_to_post using 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-server

Replace <…> 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.

Similar MCP servers

All MCP servers for Marketing and content →

Project sponsors

Companies that keep this analytics open