Provides tools for interacting with Reddit, allowing agents to browse feeds, search posts, read comments, manage submissions and replies, vote, save, and perform moderation actions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@reddit-mcp show me the top posts in r/MachineLearning"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server for a single Reddit account, built on Reddit's OAuth API via PRAW. Tools are gated into read, write and full tiers.
Create an app at https://www.reddit.com/prefs/apps with type installed app
and redirect URI http://localhost:8080/callback.
The client ID is the string under the app name, not the app name.
./bin/setup.sh./.venv/bin/python bin/auth.py --scope writeOpens Reddit's consent page and writes a refresh token to
~/.config/reddit-mcp/credentials.json (mode 0600). No password is stored, and
the grant is revocable at https://www.reddit.com/prefs/apps.
claude mcp add reddit -- /path/to/reddit-mcp/.venv/bin/python \
/path/to/reddit-mcp/src/server.pyRelated MCP server: reddit-mcp
REDDIT_MCP_SCOPE selects the tier. Default is write.
Tier | Adds | Tools |
| Browsing, search, inbox, saved, history | 9 |
| Submitting, replying, editing, deleting | 14 |
| Voting, saving, subscribing, moderation | 19 |
Tools are registered per tier, not checked at call time, so lower tiers omit the higher tools from the tool list entirely.
bin/auth.py --scope sets the OAuth scopes on the token itself, independently
of the runtime tier. A token narrower than the tier gives a second layer of
enforcement. Re-run auth.py to widen it.
Voting is in full rather than write because automated voting is the part of
Reddit's API terms enforced most aggressively.
Tool | Tier | Purpose |
| read | Account summary: karma, age, moderated subreddits |
| read | The subscribed front page |
| read | Posts in one subreddit |
| read | One post with its comment tree |
| read | Search all of Reddit or one subreddit |
| read | A user's posts and comments |
| read | Unread, all, mentions or sent |
| read | Saved posts and comments |
| read | Current subscriptions |
| write | Post a link or self post |
| write | Reply to a post or comment |
| write | Edit your own post or comment |
| write | Delete your own post or comment |
| write | Mark inbox items read |
| full | Upvote, downvote or clear |
| full | Save or unsave |
| full | Subscribe or unsubscribe |
| full | Items awaiting moderation |
| full | Approve, remove, spam, lock, unlock |
A target argument accepts a fullname (t3_abc, t1_xyz), a bare post ID, or
a reddit URL. Bare IDs resolve to posts; pass comments as t1_ fullnames or
URLs.
Variable | Default | Meaning |
|
| Tier: |
|
| Character cap per body before truncation |
|
| Credentials location |
|
| Must match the Reddit app |
| Overrides the credentials file | |
| Overrides the credentials file |
./.venv/bin/python test/smoke.pyStarts the server over stdio and checks the tool count at each tier. Runs
without credentials or network. Run it after bumping a pin in
requirements.txt, since upstream renames show up as import or registration
failures.
Live API behaviour is not covered, as that needs real credentials.
Versions are pinned. PRAW and the MCP SDK have both made breaking renames, such
as FastMCP to MCPServer in mcp 2.0.
Reddit's free API tier allows 100 queries per minute per client ID, and listings page at 100 items.
PRAW bundles update-checker, which contacts PyPI on first use. The server
disables it.
An agent posting under your account is still you as far as Reddit's moderators are concerned. Vote manipulation and spam violate the API terms.
src/config.py Credentials and scope tiers
src/server.py MCP stdio server and tool definitions
bin/auth.py One time OAuth consent flow
bin/setup.sh Creates the venv
test/smoke.py Starts the server and checks tool counts per tierMIT. See LICENSE.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Reddit MCP — public Reddit data via JSON endpoints (no auth required)
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
A basic MCP server to operate on the Postman API.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/EmptyMind4/reddit-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server