Reddit · krishnarandad2023 — Claude Code MCP server: what it does, how to install
Six Reddit tools for your agent: hot posts, comment threads, subreddit search, replies, and new posts of your own.
no license updated 2026-10-29
Open on GitHubWhat Reddit does
Six tools sit behind this server. fetchPosts returns a subreddit's hot posts, getComments reads a thread by post id, searchPosts looks for matches inside one subreddit, getSubredditInfo describes it, postComment writes a reply, and postToSubreddit creates either a text post or a link. Post and search limits run from 1 to 100, ten by default.
The code is a Python server in src/server.py, shipped with a Dockerfile. make build handles the image on Linux and macOS; on Windows the entry point is .\build.ps1 build. You need a real account: register an app at https://www.reddit.com/prefs/apps, choose script as its type, then pass REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME and REDDIT_PASSWORD into the container as environment variables.
That password travels as a plain environment variable, so give the container its own scope instead of running it next to unrelated projects. REDDIT_USER_AGENT is optional and falls back to mcp-reddit-agent/0.1.
What it helps with
- pull a subreddit's hot posts before writing a roundup
- read a thread's comments by post id
- search one subreddit for a keyword
- reply to a Reddit post from the agent
- publish a text post or a link to a subreddit
Example prompts for the agent
- Fetch ten hot posts from
technologywithfetchPosts. - Search
programmingfor python tutorial and show the first five hits. - Post to
testwith the title “MCP check” and the body “Written by the agent”.
How to install Reddit
Install
The MCP registry has no launch command for it: see the repository 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
How do I install the Reddit MCP server in Claude Code?
Clone the repository and change into its directory, build the image with make build, set REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME and REDDIT_PASSWORD, then run make test to check the server.
What does the Reddit MCP server do?
It hands the agent six tools: fetchPosts, getComments, searchPosts, getSubredditInfo, postComment and postToSubreddit. The first four read Reddit, the last two write under your account.
What do I need before starting it?
A Reddit app of type script with its client ID and secret, plus the username and password of the account, and Docker for the container route. The server itself starts with docker run --rm -i and the values supplied through -e flags.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →Reddit by other authors comes first.