reddit-mcp

Overview

The Reddit MCP server is a comprehensive implementation that allows AI assistants to interact with Reddit's API through the Model Context Protocol. It provides extensive functionality for retrieving user information, analyzing posts and comments across subreddits, and performing searches. The server offers both read-only operations and authenticated posting/commenting capabilities with intelligent analysis features including engagement metrics and timing recommendations.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_user_infoget_user_info(username)

  Get detailed user analysis with engagement insights

  Try:Analyze u/spez's Reddit activityTry:Show me my Reddit profile
• get_user_commentsget_user_comments(username, sort, time_filter, limit)

  Get a user's comment history with filtering options

  Try:Show me u/spez's recent commentsTry:Get most controversial comments by u/username
• get_user_postsget_user_posts(username, sort, time_filter, limit)

  Get a user's post/submission history with filtering options

  Try:Get the top posts by u/poem_for_your_sprog from the past year
• get_top_postsget_top_posts(subreddit, time_filter, limit)

  Get and analyze top posts from a subreddit

  Try:Show me the top posts from r/Python this week
• search_postssearch_posts(query, subreddit, sort, time_filter, limit)

  Search for posts across Reddit or within a specific subreddit

  Try:Search for posts about 'machine learning' across all of RedditTry:Find posts about 'beginner tutorials' in r/learnprogramming from this month
• get_subreddit_statsget_subreddit_stats(subreddit)

  Get comprehensive subreddit analysis

  Try:Get statistics about r/AskReddit
• get_trending_subredditsget_trending_subreddits()

  Get list of trending subreddits

  Try:What are the trending subreddits right now?
• get_submission_by_urlget_submission_by_url(url)

  Get a Reddit submission by its URL

  Try:Analyze this post: https://reddit.com/r/Python/comments/abc123
• get_submission_by_idget_submission_by_id(submission_id)

  Get a Reddit submission by its ID

  Try:Show me details of post with ID abc123
• who_am_iwho_am_i()

  Get information about the currently authenticated user

  Try:Who am I on Reddit?Try:Show my Reddit profile
• create_postcreate_post(subreddit, title, content, flair, is_self)

  Create an optimized post in a subreddit

  Try:Create a post in r/Python about a new projectTry:Post about AI developments in r/technology
• reply_to_postreply_to_post(post_id, content, subreddit)

  Add a reply with engagement insights to a post

  Try:Reply to this post with an insightful commentTry:Add a strategic reply to the discussion

Comparable tools

Installation

git clone https://github.com/Arindam200/reddit-mcp.git
cd reddit-mcp

{
  "mcpServers": {
    "reddit": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}",
        "run",
        "server.py"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password"
      }
    }
  }
}

FAQ

What authentication methods are supported?

The server supports both read-only access (requiring only client_id and client_secret) and full authenticated access (requiring client credentials plus username and password for posting and commenting).

Can I create posts and comments with this server?

Yes, but only with full authenticated access that includes your Reddit username and password. The server provides tools like create_post(), reply_to_post(), and reply_to_comment().

Compare reddit-mcp with