An MCP server that provides both read-only and authenticated access to Reddit content and interactions without requiring a developer API key. It enables users to browse posts, search subreddits, and perform write actions like commenting and voting by
What is Reddit?
Reddit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that provides both read-only and authenticated access to reddit content and interactions without requiring a developer api key. it enables users to browse posts, search subreddits, and perf...
An MCP server that provides both read-only and authenticated access to Reddit content and interactions without requiring a developer API key. It enables users to browse posts, search subreddits, and perform write actions like commenting and voting by
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- get_frontpage_posts
- get_subreddit_info
- get_subreddit_hot_posts
- get_subreddit_new_posts
- get_subreddit_top_posts
Use Cases
Maintainer
Works with
Installation
NPM
npx -y reddit-mcp-serverManual Installation
npx -y 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 read and write access to Reddit content without requiring users to create a Reddit developer application. In read-only mode it works immediately with no credentials, enabling browsing of front page posts, subreddit listings (hot, new, top), subreddit metadata, post comments, and user profiles. Authenticated mode unlocks write operations — creating posts, commenting, replying, editing, and deleting content — using standard Reddit credentials with built-in rate limiting and cross-subreddit duplicate detection to prevent spam.
Prerequisites
- Node.js 18 or higher installed
- An MCP-compatible client such as Claude Desktop or Claude Code
- Reddit account credentials (REDDIT_USERNAME and REDDIT_PASSWORD) only if you need write operations
- Optional: REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET for OAuth-based authentication (more robust for write access)
Run in read-only mode with no configuration
The server works without any credentials for read-only Reddit browsing. You can run it directly via npx to verify it starts correctly.
npx -y reddit-mcp-serverAdd the server to your MCP client configuration (read-only)
For read-only access, add the server with no environment variables. This is the safest starting point.
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "reddit-mcp-server"]
}
}
}Enable authenticated write access
To post, comment, and reply, add your Reddit credentials and set REDDIT_AUTH_MODE. Optionally provide OAuth app credentials for token-based auth.
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "reddit-mcp-server"],
"env": {
"REDDIT_USERNAME": "your_username",
"REDDIT_PASSWORD": "your_password",
"REDDIT_CLIENT_ID": "your_app_client_id",
"REDDIT_CLIENT_SECRET": "your_app_client_secret",
"REDDIT_AUTH_MODE": "oauth",
"REDDIT_SAFE_MODE": "standard"
}
}
}
}Configure safe mode for rate limiting
REDDIT_SAFE_MODE controls spam protection delays. 'standard' adds 2-second delays between write operations (default); 'strict' adds 5-second delays; 'off' removes delays entirely.
Restart your MCP client and verify tools appear
Restart Claude Desktop or your chosen client. You should see Reddit tools listed when you ask the assistant what tools are available.
Reddit Examples
Client configuration
Minimal read-only config for claude_desktop_config.json. Expand with env vars for write access.
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "reddit-mcp-server"],
"env": {
"REDDIT_USERNAME": "your_username",
"REDDIT_PASSWORD": "your_password",
"REDDIT_SAFE_MODE": "standard"
}
}
}
}Prompts to try
These prompts cover both read-only and authenticated workflows.
- "Show me the top 5 posts on Reddit's front page right now."
- "What are the hot posts in r/MachineLearning today?"
- "Give me info about the r/LocalLLaMA subreddit — subscriber count, description, and rules."
- "Find the newest posts in r/webdev from the last hour."
- "Search r/Python for posts about async programming."
- "Reply to the top comment on this Reddit post: [URL]"Troubleshooting Reddit
Write operations fail with authentication errors
Ensure REDDIT_USERNAME, REDDIT_PASSWORD, REDDIT_CLIENT_ID, and REDDIT_CLIENT_SECRET are all set correctly. Create an OAuth app at https://www.reddit.com/prefs/apps with type 'script' to get client credentials.
Posts are being rejected as duplicates
The server includes cross-subreddit duplicate detection. Wait for the duplicate post to age out, or post to a different subreddit. This is intentional behavior aligned with Reddit's spam policies.
Rate limit errors during write operations
Set REDDIT_SAFE_MODE=strict to increase delays between requests to 5 seconds. If errors persist, the Reddit account may be rate-limited at the API level — wait 10 minutes and retry.
Frequently Asked Questions about Reddit
What is Reddit?
Reddit is a Model Context Protocol (MCP) server that mcp server that provides both read-only and authenticated access to reddit content and interactions without requiring a developer api key. it enables users to browse posts, search subreddits, and perform write actions like commenting and voting by 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 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 Communication Servers
Looking for alternatives to Reddit? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication 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.