Reddit

Reddit_mcp_server

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sumitroyyy-reddit_mcp_server": {
      "command": "python",
      "args": [
        "simple_server.py"
      ],
      "env": {
        "REDDIT_PASSWORD": "your_reddit_password_here",
        "REDDIT_USERNAME": "your_reddit_username_here",
        "REDDIT_CLIENT_ID": "your_reddit_client_id_here",
        "REDDIT_USER_AGENT": "RedditMCPServer/1.0.0",
        "REDDIT_CLIENT_SECRET": "your_reddit_client_secret_here"
      }
    }
  }
}

You run a Python-based MCP server that lets Claude and other MCP-compatible assistants browse Reddit, read posts and comments, search, and publish to subreddits. This guide shows you how to install, configure, and use the server, including how to run it locally and the available programmatic tools you can invoke.

How to use

Start by launching the local MCP server from the command line so your MCP client can communicate with Reddit through the server. In a terminal, run python simple_server.py. This starts a standard input/output (stdio) MCP server that your MCP client can connect to. Once running, you can perform actions such as getting top posts from a subreddit, listing available flairs, and posting to subreddits (with or without flair) by using your MCP client commands that map to the server tools.

You can use the following capabilities to interact with Reddit through the server: - Browse posts from any subreddit and apply sort options like hot, new, rising, or top. - Retrieve detailed post information and, if desired, fetch top comments. - Search Reddit with filters for subreddit scope, sort method, and time range. - Get public information about Reddit users and subreddit details.

How to install

Prerequisites you need before installation:

Reddit API Credentials: Create a Reddit script app to obtain a Client ID and Client Secret, and set the Redirect URI to http://localhost:8080.
Python environment: Python 3.8 or higher and the pip package manager.

Step-by-step setup:

git clone https://github.com/yourusername/reddit-mcp-server.git
cd reddit-mcp-server
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your Reddit API credentials

Environment variables you need to configure in the .env file (example values shown):

REDDIT_CLIENT_ID=your_reddit_client_id_here
REDDIT_CLIENT_SECRET=your_reddit_client_secret_here
REDDIT_USER_AGENT=RedditMCPServer/1.0.0
REDDIT_USERNAME=your_reddit_username_here
REDDIT_PASSWORD=your_reddit_password_here

Additional configuration and notes

The server runs with a standard input/output interface, so you can connect using a compatible MCP client and start sending requests to perform Reddit operations. You can also easily update environment values in the .env file to switch Reddit accounts or applications as needed.

Available tools

get_subreddit_posts

Fetch posts from a specific subreddit with configurable sorting, time filter, and limit.

get_post_details

Retrieve detailed information about a specific post, with optional top comments.

get_post_comments

Retrieve comments from a post with sortable ordering and a limit.

search_reddit

Search Reddit posts with optional subreddit scoping, sorting, and time filters.

get_user_profile

Get public information about a Reddit user.

get_subreddit_info

Get detailed information about a subreddit.