Allows AI assistants to access and interact with Reddit content, providing tools for analyzing user activity, fetching posts from subreddits, retrieving subreddit statistics, viewing trending subreddits, creating posts with timing recommendations, and replying to posts/comments with engagement optimization.
Reddit MCP Server
This repository contains a Model Context Protocol server implementation for Reddit that allows AI assistants to access and interact with Reddit content through PRAW (Python Reddit API Wrapper).
What is MCP?
The Model Context Protocol (MCP) is a standard for enabling AI assistants to interface with external services, tools, and data sources. This server implements the MCP specification to provide access to Reddit content.
To know more about MCP, Check this video
Features
Get detailed user information with engagement analysis
Fetch and analyze top posts from any subreddit
Get comprehensive subreddit statistics and health metrics
View trending subreddits with growth patterns
Create strategic posts with timing recommendations
Reply to posts and comments with engagement optimization
AI-driven insights and recommendations
Smart response formatting with engagement metrics
Installation
Clone this repository
Connect to the MCP server
Copy the below json with the appropriate {{PATH}} values:
{ "mcpServers": { "reddit": { "command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here "args": [ "--directory", "{{PATH_TO_SRC}}", // cd into the repo, run `pwd` and enter the output here "run", "server.py" ], "env": { "REDDIT_CLIENT_ID": "your_client_id", "REDDIT_CLIENT_SECRET": "your_client_secret", "REDDIT_USERNAME": "your_username", // Optional for authenticated operations "REDDIT_PASSWORD": "your_password" // Optional for authenticated operations } } } }You can obtain Reddit API credentials by creating an app at Reddit's app preferences page.
For Claude, save this as
claude_desktop_config.json
in your Claude Desktop configuration directory at:~/Library/Application Support/Claude/claude_desktop_config.jsonFor Cursor, save this as
mcp.json
in your Cursor configuration directory at:~/.cursor/mcp.jsonRestart Claude Desktop / Cursor
Open Claude Desktop and you should now see Reddit as an available integration.
Or restart Cursor.
Available Tools
The server provides the following tools:
Read-only Tools (require only client credentials):
get_user_info(username)
- Get detailed user analysis with engagement insightsget_top_posts(subreddit, time_filter, limit)
- Get and analyze top postsget_subreddit_stats(subreddit)
- Get comprehensive subreddit analysisget_trending_subreddits()
- Get list of trending subredditsget_submission_by_url(url)
- Get a Reddit submission by its URLget_submission_by_id(submission_id)
- Get a Reddit submission by its ID
Authenticated Tools (require user credentials):
who_am_i()
- Get information about the currently authenticated usercreate_post(subreddit, title, content, flair, is_self)
- Create an optimized postreply_to_post(post_id, content, subreddit)
- Add a reply with engagement insightsreply_to_comment(comment_id, content, subreddit)
- Add a strategic reply
Example Queries
Here are some examples of what you can ask an AI assistant connected to this server:
"Who am I on Reddit?" or "Show my Reddit profile"
"Analyze u/spez's Reddit activity"
"Show me the top posts from r/Python this week"
"Get statistics about r/AskReddit"
"What are the trending subreddits right now?"
"Create a post in r/Python about a new project"
"Reply to this post with an insightful comment"
"What's the best time to post in this subreddit?"
Advanced Features
AI-Driven Analysis
The server provides intelligent analysis in several areas:
User Analysis
Engagement patterns
Activity trends
Community influence
Personalized recommendations
Post Analysis
Performance metrics
Engagement quality
Timing optimization
Content impact assessment
Community Analysis
Health indicators
Growth patterns
Activity metrics
Engagement opportunities
Smart Response Formatting
Organized bullet points
Engagement statistics
AI-driven insights
Strategic recommendations
Performance metrics
Authentication
The server supports two levels of authentication:
Read-only Access
Requires:
client_id
andclient_secret
Allows: Fetching public data, reading posts/comments
Authenticated Access
Requires: All read-only credentials PLUS
username
andpassword
Allows: All read-only operations PLUS posting and commenting
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server that enables AI assistants to access and interact with Reddit content through features like user analysis, post retrieval, subreddit statistics, and authenticated posting capabilities.
Related MCP Servers
- -securityFlicense-qualityA specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.Last updated -58
- AsecurityAlicenseAqualityA plug-and-play MCP server that enables AI assistants to browse, search, and read Reddit content through the PRAW library.Last updated -616MIT License
- -securityFlicense-qualityA MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.Last updated -82
- AsecurityFlicenseAqualityAn MCP server that provides AI assistants with powerful tools to interact with YouTube, including video searching, transcript extraction, comment retrieval, and more.Last updated -818