susancodes55/reddit-mcp-server

Reddit MCP Server

A Model Context Protocol (MCP) server that provides Reddit functionality including consensus gathering, top posts, helpful links, and related subreddits.

Installation

pip install git+https://github.com/susancodes55/reddit-mcp-server.git

Setup

After installation, run the following command to automatically configure your MCP client:

reddit-mcp --install

Configuration

Create a .env file in your project directory with the following variables:

Note: Google-related settings inside the '.env' file are optional.

REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret
REDDIT_USER_AGENT=your_app_name/1.0
GOOGLE_API_KEY=your_google_api_key
GOOGLE_CSE_ID=your_custom_search_engine_id

Features

• get_consensus(question) - Gets Reddit consensus based on comments
• get_top_posts(subreddit) - Get top posts for a subreddit
• get_helpful_links(input) - Get useful Reddit links related to input
• get_related_subreddits(topic) - Get subreddits related to a topic

Supported MCP Clients

• Python (3.11 or higher)
• Supported MCP Client (pick one you like)
  • Cline
  • Roo Code
  • Claude
  • Cursor
  • VSCode Agent Mode
  • Windsurf