Enables comprehensive Reddit research through a three-layer architecture that discovers relevant communities, provides operation guidance, and executes multi-subreddit content fetching with proper citations. Supports searching, post fetching, comment
What is Reddit?
Reddit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables comprehensive reddit research through a three-layer architecture that discovers relevant communities, provides operation guidance, and executes multi-subreddit content fetching with proper cit...
Enables comprehensive Reddit research through a three-layer architecture that discovers relevant communities, provides operation guidance, and executes multi-subreddit content fetching with proper citations. Supports searching, post fetching, comment
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables comprehensive Reddit research through a three-layer
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @practicaltools/reddit-mcp-serverPIP
pip install reddit-research-mcpManual Installation
npx -y @practicaltools/reddit-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Reddit
The Reddit MCP Server gives AI assistants comprehensive access to Reddit's API through a three-layer architecture that discovers relevant communities, guides operations, and fetches multi-subreddit content with proper citations. It supports read-only operations (user info, post/comment retrieval, subreddit stats, trending data, content search) with just client credentials, and authenticated write operations (post creation, replies) with username and password. Built with FastMCP and designed for market research, competitive analysis, and customer discovery workflows.
Prerequisites
- Python 3.9 or newer with uv installed
- A Reddit account
- A Reddit API app registered at reddit.com/prefs/apps (script type) to obtain Client ID and Client Secret
- Reddit username and password (optional, required only for write operations)
- An MCP client such as Claude Desktop or Cursor
Register a Reddit API application
Go to https://www.reddit.com/prefs/apps, click 'create another app', choose 'script' type, and note your Client ID (shown under the app name) and Client Secret.
Install the package
Install the reddit-research-mcp package via pip or use npx for the Node.js wrapper.
pip install reddit-research-mcpClone the source (for uv-based setup)
If running via uv from source, clone the repository.
git clone https://github.com/Arindam200/reddit-mcp.git
cd reddit-mcpConfigure Claude Desktop
Add the Reddit MCP server to your Claude Desktop configuration with your API credentials.
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "@practicaltools/reddit-mcp-server"],
"env": {
"REDDIT_CLIENT_ID": "your_client_id_here",
"REDDIT_CLIENT_SECRET": "your_client_secret_here",
"REDDIT_USERNAME": "your_reddit_username",
"REDDIT_PASSWORD": "your_reddit_password"
}
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop and ask it to fetch top posts from a subreddit or search for a topic on Reddit to confirm the connection.
Reddit Examples
Client configuration
Claude Desktop configuration for the Reddit MCP server using the npm package. Omit REDDIT_USERNAME and REDDIT_PASSWORD for read-only mode.
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "@practicaltools/reddit-mcp-server"],
"env": {
"REDDIT_CLIENT_ID": "your_client_id_here",
"REDDIT_CLIENT_SECRET": "your_client_secret_here",
"REDDIT_USERNAME": "your_reddit_username",
"REDDIT_PASSWORD": "your_reddit_password"
}
}
}
}Prompts to try
Use these prompts in Claude Desktop to perform Reddit research with the MCP server connected.
- "Show me the top posts from r/Python this week."
- "Search for posts about 'machine learning ops' across all of Reddit."
- "Analyze the sentiment in comments on the top 5 posts in r/startups this month."
- "Find relevant subreddits where people discuss project management tools."
- "Fetch recent posts mentioning competitor X from r/SaaS and r/Entrepreneur."
- "What are users complaining about regarding Notion in r/productivity?"Troubleshooting Reddit
Authentication returns '401 Unauthorized' or 'invalid_grant'
Verify your REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are correct. The Client ID is the short string shown below your app name on reddit.com/prefs/apps, not the app name itself. Ensure your app type is 'script'.
Write operations (post creation, replies) fail with 'RATELIMIT' or permission errors
Write operations require REDDIT_USERNAME and REDDIT_PASSWORD to be set. New Reddit accounts may face karma or age restrictions on posting — ensure your account has some history. Also respect Reddit's rate limits (one request per second).
Subreddit content returns empty results
Check that the subreddit name is spelled correctly and is not private or quarantined. For NSFW subreddits, the API may require additional OAuth scopes. Try a public subreddit like r/Python to confirm the connection is working.
Frequently Asked Questions about Reddit
What is Reddit?
Reddit is a Model Context Protocol (MCP) server that enables comprehensive reddit research through a three-layer architecture that discovers relevant communities, provides operation guidance, and executes multi-subreddit content fetching with proper citations. supports searching, post fetching, comment It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Reddit?
Install via npm with the command: npx -y @practicaltools/reddit-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Reddit?
Reddit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Reddit free to use?
Yes, Reddit is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Reddit Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Reddit? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Reddit in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Reddit?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.