Skip to main content
Glama
reddit-mcp

reddit-mcp

by tonyzorin

Reddit MCP Server

A full-featured Reddit MCP (Model Context Protocol) server built with FastMCP and PRAW. Runs in Docker and integrates with Cursor AI.

Prerequisites

  • Docker

  • A Reddit account with API credentials

Related MCP server: MCP Reddit Server

Reddit API Setup

  1. Go to https://www.reddit.com/prefs/apps

  2. Click "create another app..."

  3. Choose script type

  4. Set redirect URI to http://localhost:8080

  5. Note the client_id (shown under the app name) and client_secret

Build the Docker Image

docker build -t reddit-mcp /home/anton/reddit-mcp

Cursor Configuration

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "reddit": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "REDDIT_CLIENT_ID",
        "-e", "REDDIT_CLIENT_SECRET",
        "-e", "REDDIT_USERNAME",
        "-e", "REDDIT_PASSWORD",
        "-e", "REDDIT_USER_AGENT",
        "reddit-mcp"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password",
        "REDDIT_USER_AGENT": "cursor:reddit-mcp:v1.0 (by /u/your_username)"
      }
    }
  }
}

Available Tools

Reading

Tool

Description

get_subreddit_posts

Fetch hot/new/top/rising posts from a subreddit

get_post_details

Get a post with its top comments

get_user_profile

View a Reddit user's profile and recent activity

search_reddit

Search posts across Reddit or within a subreddit

search_subreddits

Find subreddits by keyword

get_subreddit_info

Get subreddit metadata (rules, description, subscriber count)

Writing

Tool

Description

submit_post

Create a new text or link post

submit_comment

Reply to a post or comment

vote

Upvote/downvote/unvote on a post or comment

save_item

Save or unsave a post or comment

Monitoring

Tool

Description

get_trending

Get trending posts across Reddit

get_my_profile

View your authenticated profile and karma

get_saved_items

List your saved posts and comments

Rate Limits

Reddit allows 60 authenticated requests per minute. PRAW handles this automatically.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables comprehensive Reddit interaction including fetching posts, analyzing users and subreddits, searching content, and creating posts/comments. Supports both read-only mode with client credentials and full functionality with user authentication.
      17
      1,654 npm
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with Reddit through the Reddit API, allowing users to search posts, retrieve saved content, fetch comments, reply to comments, and access detailed post information with comment trees.
      4
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables browsing, searching, and reading Reddit posts, comments, and subreddits through Reddit's API using PRAW.
      6
      MIT