How to Set Up an MCP Server for Reddit

A Reddit MCP server sits between your AI agent and Reddit's data. It translates agent requests into Reddit API calls, then returns structured results the agent can reason about. The Model Context Protocol standardizes this interface, so the same agent that reads your files or queries a database can also search r/MachineLearning or pull comment threads from r/LocalLLaMA.

Reddit reported 121.4 million daily active users in Q4 2025, with 471.6 million weekly active users. That volume of human discussion makes Reddit uniquely useful for market research, sentiment analysis, product feedback monitoring, and technical troubleshooting. But connecting an AI agent to Reddit manually means writing API wrappers, managing OAuth tokens, and handling rate limits. An MCP server handles all of that behind a standard tool interface.

Several open-source Reddit MCP servers exist, each targeting different use cases. Some work with zero credentials using Reddit's public JSON endpoints. Others support full OAuth authentication for higher rate limits and write access. The right choice depends on whether you need read-only browsing or the ability to post and reply.

Three open-source Reddit MCP servers stand out. Each takes a different approach to authentication, tooling, and scope.

jordanburke/reddit-mcp-server (TypeScript)

This is the most full-featured option. Built with TypeScript and FastMCP, it provides both read and write tools. Read tools include get_reddit_post, get_top_posts, search_reddit, get_post_comments, get_subreddit_info, get_trending_subreddits, get_user_info, get_user_posts, and get_user_comments. Write tools cover create_post, reply_to_post, edit_post, edit_comment, delete_post, and delete_comment.

It runs via npx with no global install required and supports three authentication tiers: anonymous (zero credentials, ~10 requests/minute), app-only OAuth (60 requests/minute), and fully authenticated (100 requests/minute with write access). A built-in safe mode protects against Reddit's spam detection, and an optional bot disclosure footer marks posts as AI-generated.

Best for: Agents that need to both read and write on Reddit.

Install command:

npx reddit-mcp-server

Hawstein/mcp-server-reddit (Python)

A read-only Python server focused on content consumption. It provides eight tools: get_frontpage_posts, get_subreddit_info, get_subreddit_hot_posts, get_subreddit_new_posts, get_subreddit_top_posts, get_subreddit_rising_posts, get_post_content, and get_post_comments. The get_post_content tool retrieves full post details with configurable comment tree depth (1 to 10 levels).

It runs via uvx with no install step and uses the redditwarp library for API interactions. This server works without any credentials, making it the fastest path to getting Reddit data into your agent.

Best for: Quick read-only access with minimal setup.

Install command:

uvx mcp-server-reddit

KalGuinn/reddit-mcp (Python)

A lightweight Python server designed around zero-credential anonymous access. It provides four focused tools: get_subreddit_posts, search_subreddit, get_post_details, and user_analysis. The anonymous tier uses Reddit's public .json endpoints, covering every read path without any API keys.

If you do add credentials, it supports the same three tiers as jordanburke's server (anonymous at 10 rpm, app-only OAuth at 60 rpm, authenticated at 100 rpm). The server auto-detects which tier to use based on which environment variables are set.

Best for: Lightweight monitoring and research without API credentials.

The jordanburke/reddit-mcp-server is the most common starting point because it works with zero credentials and supports write operations when you add them later. Here is the full setup process.

1. Verify Node.js Is Installed

The server runs via npx, which ships with Node.js. Check your version:

node --version

You need Node.js 18 or later. If it is not installed, download it from nodejs.org or use a version manager like nvm.

2. Add the Server to Your MCP Configuration

For Claude Desktop, open your configuration file. On macOS, it is at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, it is at %APPDATA%\Claude\claude_desktop_config.json.

Add the Reddit server to the mcpServers block:

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"],
      "env": {
        "REDDIT_AUTH_MODE": "anonymous"
      }
    }
  }
}

This configuration runs in anonymous mode with no credentials. You can browse subreddits, search posts, and read comments immediately.

3. Test the Connection Restart Claude Desktop. In the chat, you should see the Reddit MCP tools available. Try a basic query like "search r/programming for posts about MCP servers" or "get the top posts from r/LocalLLaMA this week."

If the tools do not appear, check that npx can run the package by executing npx reddit-mcp-server in your terminal. Fix any Node.js path issues before retrying.

4. Add Reddit API Credentials (Optional)

Anonymous mode caps you at roughly 10 requests per minute. For higher throughput, register a Reddit app:

1. Go to reddit.com/prefs/apps
2. Click "create another app" at the bottom
3. Select "script" as the app type
4. Set the redirect URI to http://localhost:8080
5. Note the client ID (string under your app name) and client secret

Then update your MCP configuration:

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_AUTH_MODE": "auto"
      }
    }
  }
}

App-only OAuth gives you 60 requests per minute. For write access (posting, commenting, editing), add REDDIT_USERNAME and REDDIT_PASSWORD to the env block as well, which increases the limit to 100 requests per minute.

A note on Reddit's API policy: Reddit tightened its Responsible Builder Policy in late 2025, adding an approval gate for new app registrations. Personal script apps are usually approved quickly, but commercial use cases may face delays or require paid API access starting at $0.24 per 1,000 calls.

Persist your Reddit research across sessions

Store agent findings in an intelligent workspace with built-in search and collaboration. 50 GB free, no credit card, MCP-ready from day one.

Sign Up Free

A Reddit MCP server becomes genuinely useful when you pair it with specific workflows rather than treating it as a generic browsing tool.

Market Research and Sentiment Tracking

Point your agent at subreddits where your target audience discusses problems. An agent monitoring r/selfhosted, r/sysadmin, or r/smallbusiness can surface recurring complaints, feature requests, and product comparisons that would take hours to find manually. Combine search_reddit queries with date filtering to track how sentiment around a topic shifts over time.

Technical Troubleshooting Research

When debugging an obscure error, Reddit threads often contain solutions that Stack Overflow misses. An agent can search across r/webdev, r/node, r/python, and r/devops simultaneously, pull relevant comment threads, and synthesize answers from multiple discussions. The get_post_comments tool with deep threading (up to 10 levels on the Hawstein server) captures the back-and-forth where real solutions emerge.

Content Research and Ideation

Before writing about a topic, search Reddit to see what questions people actually ask, what misconceptions are common, and which existing resources get recommended. This grounds your content in real user needs rather than keyword assumptions. Pull top posts from relevant subreddits, read the comment threads, and identify gaps in existing coverage.

Competitor and Product Monitoring

Track mentions of your product, your competitors, or your industry across relevant subreddits. An agent can run daily searches, flag posts above a certain engagement threshold, and compile weekly summaries. This is particularly useful for B2B products where Reddit discussions often surface honest opinions that review sites filter out.

Community Engagement (With Write Access)

If you enable write tools with full authentication, an agent can draft responses to questions in your product's subreddit, participate in relevant discussions, or share content. The jordanburke server includes a safe mode that throttles posting frequency to avoid triggering Reddit's spam filters, and an optional bot disclosure footer that transparently marks responses as AI-assisted.

Reddit MCP tools give your agent access to live data, but that data is ephemeral. Subreddit rankings change hourly, posts get deleted, and comment threads evolve. If your agent is doing ongoing research, you need somewhere to persist findings between sessions.

Local files work for individual projects. Your agent can write Reddit search results to markdown files or JSON documents on disk. But this breaks down when multiple agents collaborate on research, when you need to hand off findings to a colleague, or when you want to search across accumulated research later.

S3 or similar object storage gives you durability but no built-in search, no previews, and no collaboration tools. You end up building metadata layers on top of raw storage.

Fast.io workspaces handle the full loop. An agent stores Reddit research as files in a shared workspace. With Intelligence Mode enabled, those files are automatically indexed for semantic search, so you can ask questions across weeks of accumulated research without writing a custom retrieval pipeline. Multiple agents and humans share the same workspace, and the Fast.io MCP server lets agents read and write workspace files through the same protocol they use to access Reddit.

A practical setup looks like this: one agent pulls Reddit data through a Reddit MCP server and writes structured summaries to a Fast.io workspace. A second agent (or a human) queries that workspace through Intelligence Mode to find patterns, draft reports, or identify action items. The workspace provides version history, audit trails, and granular permissions, so you know who found what and when.

The free plan includes 50 GB of storage, 5,000 AI credits per month, and 5 workspaces, with no credit card and no expiration. That is enough to run ongoing Reddit research across several topics without hitting limits.

Environment Variables

The jordanburke/reddit-mcp-server supports these configuration options:

• REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET: OAuth app credentials from reddit.com/prefs/apps. Optional for anonymous mode.
• REDDIT_USERNAME and REDDIT_PASSWORD: Required only for write operations (posting, commenting, editing).
• REDDIT_AUTH_MODE: Set to anonymous, auto, or authenticated. The auto setting detects available credentials and uses the highest tier possible.
• REDDIT_SAFE_MODE: Controls posting safeguards. Options are off, standard, or strict. Standard mode adds delays between write operations to avoid spam detection.
• REDDIT_BOT_DISCLOSURE: Set to auto to append a footer identifying posts as bot-generated, or off to disable.

Docker Deployment

For running the server in a container instead of via npx:

docker pull ghcr.io/jordanburke/reddit-mcp-server:latest
docker run -d --name reddit-mcp -p 3000:3000 \
  -e REDDIT_CLIENT_ID=your_id \
  -e REDDIT_CLIENT_SECRET=your_secret \
  -e REDDIT_SAFE_MODE=standard \
  ghcr.io/jordanburke/reddit-mcp-server:latest

Common Issues

Tools not appearing in Claude Desktop. Restart the application after editing the config file. Verify npx can run the package by testing npx reddit-mcp-server in your terminal. Check that Node.js 18+ is on your system PATH.

Rate limit errors with anonymous mode. Anonymous access is capped at roughly 10 requests per minute. If your agent makes rapid sequential calls (searching multiple subreddits, then fetching comments for each result), it will hit this limit quickly. Add OAuth credentials to increase the cap to 60 rpm.

Authentication failures after adding credentials. Double-check that your client ID is the short string directly under the app name on reddit.com/prefs/apps, not the longer secret. Verify the app type is set to "script." If you recently created the app and Reddit's approval gate is active, the credentials may not work until the app is approved.

Write operations fail silently. Posting and commenting require REDDIT_USERNAME and REDDIT_PASSWORD in addition to OAuth credentials. The account must also have enough karma and account age to pass Reddit's spam filters in the target subreddit. Some subreddits have minimum karma thresholds that block new or low-karma accounts.

Stale data or missing posts. Reddit's API can return cached results, especially for "hot" and "rising" endpoints. If you need real-time data, use "new" endpoints instead. Deleted posts and removed comments will not appear in API results regardless of the endpoint.