reddit-mcp

reddit-mcp

Read-only Reddit MCP server, packaged as a Claude Cowork plugin. Browse subreddits, fetch posts and comment trees, search Reddit, inspect users, and read subreddit rules — all via Reddit's app-only OAuth API.

Setup

1. Register an app at https://www.reddit.com/prefs/apps (type script or web app). Copy the client id (under the app name) and the secret.
2. Set the three env vars in your shell or in Cowork's plugin env:
   • REDDIT_CLIENT_ID
   • REDDIT_CLIENT_SECRET
   • REDDIT_USER_AGENT — must be descriptive, e.g. reddit-mcp/0.1 by /u/yourname. Reddit rejects generic UAs.
3. Install Bun if you don't have it.

Run standalone (for testing)

bun install
bun server.ts

The server speaks MCP over stdio. Easiest way to poke at it:

npx @modelcontextprotocol/inspector bun server.ts

Install into Claude Cowork

The plugin is structured the standard way (.claude-plugin/plugin.json, .mcp.json). Add it to a local marketplace or symlink the directory into ~/.claude/plugins/marketplaces/<name>/external_plugins/reddit-mcp/, then /plugin install reddit-mcp. Confirm with /mcp — reddit should be listed.

Tools

Tool	What it does
get_subreddit_posts	List posts from a subreddit (hot/new/top/rising/controversial)
get_post	Fetch a post with its comment tree
search_posts	Search Reddit, optionally restricted to a subreddit
get_subreddit_about	Subreddit metadata (description, subscribers)
get_subreddit_rules	Subreddit rules + sitewide rules
get_user_posts	A user's submissions
get_user_comments	A user's comments
search_subreddits	Find subreddits by query

All responses are trimmed projections of Reddit's JSON — media embeds, awardings, and preview thumbnails are stripped to keep model context small.

Limits

App-only OAuth allows ~100 requests/minute. The token (~24h) is cached in-process and refreshed on 401 or near expiry. No write actions are exposed.