Provides tools for interacting with Reddit's API, including retrieving saved posts, searching posts across subreddits, fetching comments, replying to comments, and retrieving detailed post content with comment trees.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Reddit MCP Serversearch for posts about Python programming in r/learnpython"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Reddit MCP Server
This project implements a Model Context Protocol (MCP) server that provides tools for interacting with the Reddit API.
Features
Get Saved Posts: Retrieve a list of saved Reddit posts for the authenticated user.
Search Reddit: Search for posts across all of Reddit or within a specific subreddit.
Get Comments: Fetch comments from a specific Reddit submission.
Reply to Comment: Post a reply to an existing Reddit comment.
Fetch Reddit Post Content: Fetch detailed content of a specific Reddit post, including a comment tree, using the
redditwarplibrary.
Setup
Prerequisites
Python 3.12 or higher.
Installation
Clone the repository (if applicable, otherwise ensure you have the project files):
git clone https://github.com/netixc/reddit-mcp-server.git cd reddit-mcp-serverCreate a Python virtual environment:
uv sync
This will install praw, fastmcp, python-dotenv, and redditwarp.
Reddit API Configuration
You need to set up Reddit API credentials for your application. These can be obtained by creating an application on Reddit's developer page (https://www.reddit.com/prefs/apps).
Running the MCP Server
The server uses both PRAW (for get_saved_posts, search_reddit, get_comments, reply_to_comment) and redditwarp (for fetch_reddit_post_content) to interact with the Reddit API.
PRAW API Configuration
Note: Replace YOUR_REDDIT_CLIENT_ID, YOUR_REDDIT_CLIENT_SECRET, YOUR_REDDIT_USERNAME, and YOUR_REDDIT_PASSWORD with your actual Reddit API credentials for PRAW authentication. redditwarp does not require explicit credential setup in the server.py or .env file as used in this project.
Available Tools
Once the server is running and configured in your MCP client, you can call its tools.
get_saved_posts(limit: int = 25, subreddit: Optional[str] = None)
Fetches a list of saved Reddit posts for the authenticated user.
limit(int, optional): The maximum number of saved posts to retrieve. Defaults to 25.subreddit(str, optional): If provided, only posts from this specific subreddit will be returned.
search_reddit(query: str, subreddit: Optional[str] = None, sort: str = "relevance", limit: int = 10)
Searches Reddit for posts matching a given query.
query(str): The search query.subreddit(str, optional): If provided, the search will be limited to this specific subreddit.sort(str, optional): The sorting method for the search results (e.g., "relevance", "hot", "new", "top", "comments"). Defaults to "relevance".limit(int, optional): The maximum number of search results to retrieve. Defaults to 10.
get_comments(submission_id: str, limit: int = 25)
Fetches comments from a specific Reddit submission.
submission_id(str): The ID of the Reddit submission (post) to fetch comments from.limit(int, optional): The maximum number of comments to retrieve. Defaults to 25.
reply_to_comment(comment_id: str, text: str)
Replies to a specific Reddit comment.
comment_id(str): The ID of the comment to reply to.text(str): The text content of the reply.
fetch_reddit_post_content(post_id: str, comment_limit: int = 20, comment_depth: int = 3)
Fetch detailed content of a specific post, including a recursive comment tree. This tool utilizes the redditwarp library.
post_id(str): The ID of the Reddit post to fetch content from.comment_limit(int, optional): The number of top-level comments to fetch. Defaults to 20.comment_depth(int, optional): The maximum depth of the comment tree to traverse. Defaults to 3.