Reddit MCP Server
A PRAW-based Reddit MCP server: an agent searches posts, reads user and subreddit history and can post as you if allowed
- 302 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The write tools publish posts and replies as your account, and they cannot be recalled once sent
- For publishing, the Reddit account password sits in the client configuration
- The server collects and analyzes the public history of specific users
Install
- Works in
Manual install
git clone https://github.com/Arindam200/reddit-mcp.gitThen add the server to the client configuration; it runs through uv and server.py.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The write tools publish posts and replies as your account, and they cannot be recalled once sent
- For publishing, the Reddit account password sits in the client configuration
- The server collects and analyzes the public history of specific users
This is third-party code. Review the repository files before installing.
What it does
Reddit MCP Server connects an agent to Reddit through the PRAW library and gives it 13 tools. Nine of them only read and need nothing but app keys. They fetch a user's profile, posts and comments, search posts and pull the top posts for a period. Three more show subreddit stats, growing communities and a post by URL or ID. Results come with engagement metrics and short takeaways. Four tools act as your account: who_am_i, create_post, reply_to_post and reply_to_comment. They are for when the agent has to publish a post or reply in a thread. The server starts with `uv run server.py` from the cloned repository, and keys go in through environment variables in the client config.
Who it is for. For marketers, researchers and developers who need to study Reddit discussions and track communities through an agent.
Good fit when
- You need to find product discussions by keyword across several subreddits and boil them into a short digest
- You want to understand what a community lives on: subreddit stats, top posts for a week or a month
- You need to review a specific account's comment and post history filtered by period
- You want to draft a reply to a post and publish it after your review
- You want to watch growing subreddits
Not a fit when
- You need a full dump or archive: the server works through the Reddit API with its limits and returns a limited number of items
- You need Reddit direct messages: the server has no tools for them
- You want mass posting or vote manipulation: publishing happens from your real account, and the platform's rules do not welcome it
Example request
Find posts in r/selfhosted from the last month about home server monitoring and give me the top 5 with the main opinionsMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
REDDIT_CLIENT_IDrequired- Reddit app id
REDDIT_CLIENT_SECRETrequired, secret- Reddit app secret
REDDIT_USERNAME- Username, needed for posting and replying
REDDIT_PASSWORDsecret- Account password, needed for posting and replying
Limitations
You need a Reddit account and your own Reddit app, which provides REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET. Setup is manual: you clone the repository and run it through uv, and there is no package in a registry. The server calls the Reddit API through PRAW and is bound by its limits, so results are capped in size. Takeaways about user activity and subreddit health come from public data: they are a pointer for analysis with no accuracy guarantee.
How to disable. Remove the reddit entry from the Claude Desktop or Cursor configuration and restart the client. If you supplied a password, change it and delete the app at reddit.com/prefs/apps.
FAQ
How do I connect Reddit to Claude Desktop or Cursor?
Clone the repository and add an entry to the client configuration with the uv command and the arguments --directory, the folder path, run and server.py. For Claude Desktop the file is ~/Library/Application Support/Claude/claude_desktop_config.json, for Cursor it is ~/.cursor/mcp.json.
Where do I get REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET?
Create an app at reddit.com/prefs/apps. Put the app id and secret into the environment variables in the client configuration.
Can I work without an account password?
Yes. The nine read tools, from search_posts to get_submission_by_id, need only the app keys. The username and password are needed for who_am_i, create_post, reply_to_post and reply_to_comment.
What filters does post search have?
search_posts takes a query, a subreddit name, sorting, the time_filter period and a limit. get_top_posts and the user history tools use a similar set of parameters.
How is this server different from other Reddit MCP servers?
It combines reading with posting and replying and adds analysis of user activity and subreddit health. Installation is manual, with no published package.
Discussion
No questions or reviews yet.
Related
MCP serversA Reddit MCP server: the agent browses posts, searches content and analyzes user activity with no fluff
MCP server for Reddit: an agent reads hot threads from a subreddit and analyzes posts with their comments
Official Apify MCP server: the agent runs ready-made Apify Store scrapers for social media, maps, search and shops
A Wikipedia MCP server: an agent searches articles and pulls full text, sections, links and summaries in the language you need
A unified search MCP server: one interface to Tavily, Brave, Kagi, Exa, Linkup, Firecrawl and GitHub search
Official Oxylabs MCP server: page scraping with JS rendering, Google and Amazon results, an AI crawler
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Reddit MCP Server (this entry) | no | API key | 302 | |
| Reddit MCP Buddy | no | not required | 866 | a read-oriented Reddit server for browsing posts and analyzing users; this one adds posting and reply tools |
| MCP Reddit Server | no | not required | 433 | reads a subreddit's hot threads with comments; this one goes wider on user and community analysis |
README in short
The README gives step-by-step setup with ready JSON for the client. Tables of read and authenticated tools follow, then sample prompts and a description of the two auth levels.