home / mcp / reddit mcp server

Reddit MCP Server

Provides tools to fetch Reddit content analytics and to create or reply to Reddit posts via an MCP interface.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aflekkas-reddit-mcp-server": {
      "command": "node",
      "args": [
        "C:\\path\\to\\reddit-mcp-server\\build\\index.js"
      ],
      "env": {
        "REDDIT_PASSWORD": "YOUR_REDDIT_PASSWORD",
        "REDDIT_USERNAME": "YOUR_REDDIT_USERNAME",
        "REDDIT_CLIENT_ID": "YOUR_CLIENT_ID",
        "REDDIT_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

You run the Reddit MCP Server to fetch and create Reddit content through a programmable interface. It exposes read-only tools for analysis and read-write actions for posting and replying, enabling you to integrate Reddit data and interactions into your own MCP client workflows.

How to use

Once you have the Reddit MCP Server running, you interact with it via an MCP client. You can perform read-only operations to analyze users, posts, and subreddits, or switch to read-write operations to create posts and respond to content. Use the available functions to fetch information before composing strategic posts or replies. Always ensure your credentials are kept secure and do not expose them in client requests.

How to install

Prerequisites you need before installation:

- Node.js installed on your machine

- npm (comes with Node.js) or npx for running MCP tools

Additional notes

The server provides both read-only and read-write capabilities. If you want to perform write operations, ensure you have valid Reddit credentials and that you understand Reddit’s posting policies and rate limits.

Available tools

get_user_info

Fetch detailed user analysis with engagement insights to understand a user’s activity and influence.

get_top_posts

Retrieve and analyze top posts from a subreddit within a specified time window.

get_subreddit_stats

Provide comprehensive analytics for a given subreddit, including activity and growth metrics.

get_trending_subreddits

Return a list of currently trending subreddits based on activity and growth.

create_post

Publish a new post to a subreddit with a given title, content, flair, and self-post flag.

reply_to_post

Post a reply to a specific post with optional engagement-focused content.

reply_to_comment

Reply to an existing comment with strategic content to boost engagement.