reddit-mcp-server

jordanburke/reddit-mcp-server

3.3

If you are the rightful owner of reddit-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server for interacting with Reddit, providing tools for fetching and creating content.

The Reddit MCP Server is a specialized protocol server designed to facilitate interaction with Reddit's vast repository of content. It allows users to fetch and create Reddit content through a set of well-defined tools. This server is a fork of the original reddit-mcp-server by Alexandros Lekkas, updated to include modern build systems like pnpm and tsup, and supports npx execution. The server offers both read-only and write capabilities, enabling users to retrieve information about posts, subreddits, and users, as well as create new posts and replies. The server is designed to be integrated with platforms like Claude Desktop, providing a seamless experience for users looking to automate or enhance their Reddit interactions.

Features

  • Fetch specific Reddit posts and comments
  • Retrieve top posts from subreddits based on time filters
  • Access user and subreddit information
  • Search for posts across Reddit with various filters
  • Create new posts and reply to existing ones

Usages

usage with Claude Desktop

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": [
        "reddit-mcp-server"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "REDDIT_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "REDDIT_USERNAME": "<YOUR_USERNAME_OPTIONAL>",
        "REDDIT_PASSWORD": "<YOUR_PASSWORD_OPTIONAL>"
      },
      "autoApprove": [
        "get_reddit_post",
        "get_top_posts",
        "get_user_info",
        "get_subreddit_info",
        "get_trending_subreddits",
        "search_reddit",
        "get_post_comments",
        "get_user_posts",
        "get_user_comments",
        "create_post",
        "reply_to_post"
      ]
    }
  }
}

Tools

  1. get_reddit_post

    Get a specific Reddit post

  2. get_top_posts

    Get top posts from a subreddit

  3. get_user_info

    Get information about a Reddit user

  4. get_subreddit_info

    Get information about a subreddit

  5. get_trending_subreddits

    Get currently trending subreddits

  6. search_reddit

    Search for posts on Reddit

  7. get_post_comments

    Get comments for a specific Reddit post

  8. get_user_posts

    Get posts submitted by a specific user

  9. get_user_comments

    Get comments made by a specific user

  10. create_post

    Create a new post in a subreddit

  11. reply_to_post

    Post a reply to an existing Reddit post