Reddit MCP
Gives agents Reddit read/write via PRAW: analyze users and subreddits, search posts, create posts and replies.
Add to your client
Copy the config for your MCP client and paste it into its config file.
git clone https://github.com/Arindam200/reddit-mcp.gitPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"reddit-mcp": {
"command": "uv",
"args": [
"--directory",
"<path-to-reddit-mcp>",
"run",
"server.py"
],
"env": {
"REDDIT_CLIENT_ID": "<your-client-id>",
"REDDIT_CLIENT_SECRET": "<your-client-secret>",
"REDDIT_USERNAME": "<your-username>",
"REDDIT_PASSWORD": "<your-password>"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- uv installed (the config runs `uv --directory ... run server.py`)
- A Reddit app of type 'script' created at reddit.com/prefs/apps — gives you the client ID and secret
- For write tools only: your Reddit username and password (won't work with 2FA-enabled accounts)
About Reddit MCP
The server is a straightforward PRAW wrapper with an opinionated analysis layer. Read tools hit Reddit's official API with app-level credentials (a free 'script' app from reddit.com/prefs/apps): user info and comment/post histories with sort and time filters, top posts from any subreddit, post search with query/subreddit/sort/time parameters, subreddit statistics, trending subreddits, and direct submission lookup by URL or ID.
Authentication is two-tier by design. Client ID + secret alone gives you every read tool — good enough for research and monitoring, and the safer default. Adding REDDIT_USERNAME and REDDIT_PASSWORD switches PRAW into authenticated mode and enables who_am_i, create_post, reply_to_post and reply_to_comment. The write tools come wrapped in 'strategic' guidance — posting-time recommendations, engagement insights — which is really the server formatting API data into advice, not a separate ML system.
Deployment is clone-and-run: there's no PyPI package, so your MCP config invokes uv --directory <repo-path> run server.py. That means updates are git pull, and the config's env block is where all four credentials live — worth remembering if you sync dotfiles publicly.
Limits to know: password-based auth won't work on Reddit accounts with 2FA enabled (PRAW limitation), Reddit's API rate limits apply per app, and automated posting sits in a gray zone — allowed via the official API, but individual subreddits ban bot-like content aggressively. Read-heavy use (community research, content discovery) is where this server is strongest; MIT-licensed with 291 stars.
Tools & capabilities (13)
get_user_infoDetailed user analysis with engagement insights
get_user_commentsA user's comment history with sort and time filters
get_user_postsA user's post history with sort and time filters
get_top_postsTop posts from a subreddit for a given time window
search_postsSearch posts across Reddit or within a specific subreddit
get_subreddit_statsSubreddit statistics and health metrics
get_trending_subredditsCurrently trending subreddits
get_submission_by_urlFetch a Reddit submission by its URL
get_submission_by_idFetch a Reddit submission by its ID
who_am_iInfo about the currently authenticated user (requires user credentials)
create_postCreate a post in a subreddit, with timing recommendations (requires user credentials)
reply_to_postReply to a post (requires user credentials)
reply_to_commentReply to a comment (requires user credentials)
When to use it
- Community research: analyze a subreddit's top posts, stats and posting patterns before launching or posting there
- Audience/user analysis: summarize a Redditor's post and comment history for engagement patterns
- Content discovery: search 'machine learning' posts across Reddit or within r/learnprogramming for the past month
- Assisted posting: draft and publish a post or reply with the agent, using the timing recommendations
Quick setup
- 1Create a 'script' app at https://www.reddit.com/prefs/apps and note the client ID and secret
- 2Clone the repo: `git clone https://github.com/Arindam200/reddit-mcp.git`
- 3Add the config block to claude_desktop_config.json or ~/.cursor/mcp.json — command is your `which uv` path, args use `--directory <repo path> run server.py`
- 4Fill the env block: REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET (add USERNAME/PASSWORD only if you want posting)
- 5Restart Claude Desktop or Cursor and test with 'show me the top posts from r/Python this week'
Security notes
Reddit API credentials — and, if you enable writes, your actual Reddit username and password — sit in plain text in the MCP config's env block. Read-only mode needs only client id/secret, so leave the password out unless you want the agent posting; anything it posts is live content under your account and subject to subreddit rules.
Reddit MCP FAQ
Is reddit-mcp safe and free to use?
Yes — it's MIT-licensed and uses Reddit's free official API via PRAW, no scraping. The main cautions: credentials (including your Reddit password if you enable writes) live in plain text in the config env, and automated posting must respect subreddit rules or you'll get banned by moderators, not by the API.
Do I need my Reddit password?
Only for write operations. Client ID + secret (from a free script app at reddit.com/prefs/apps) unlocks all nine read tools; username and password are needed solely for who_am_i, create_post and the reply tools. Note password auth fails on accounts with 2FA enabled.
Can it post to Reddit automatically?
Yes — with user credentials configured, create_post, reply_to_post and reply_to_comment publish live content under your account. The server adds timing and engagement recommendations, but you're responsible for following each subreddit's self-promotion and bot rules.
Alternatives to Reddit MCP
Compare all alternatives →
Connect your personal WhatsApp: search, read and send messages and media locally
Lets agents read LinkedIn profiles, companies, jobs and messages through your own logged-in browser session.
Powerful Slack MCP with stdio/SSE/HTTP, DMs, group DMs and no-admin token auth