Skip to main content
Glama
MufanQiu

reddit-readonly-mcp

by MufanQiu
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

reddit-readonly-mcp

A small, policy-conscious Model Context Protocol (MCP) server for approved, read-only access to public Reddit discussions.

IMPORTANT

This project does not bypass Reddit access controls. Obtain explicit Reddit approval and OAuth credentials before using it. It provides no anonymous scraping or unauthenticated JSON fallback.

Design

  • Four read-only tools: list posts, search within one community, get a post, and get its comments.

  • App-only OAuth authentication against Reddit's official API.

  • Access to publicly viewable subreddits, with an optional operator allowlist and conservative result and comment limits.

  • Serialized requests with a configurable minimum interval.

  • A bounded in-memory cache with a hard one-hour maximum lifetime.

  • No write operations, user-history tools, telemetry, persistent database, or recovery of removed content.

Related MCP server: Reddit MCP Tool

Tools

Tool

Purpose

list_subreddit

List hot, new, rising, top, or controversial posts from one public subreddit.

search_posts

Search public posts inside one public subreddit.

get_post

Retrieve one public post from a Reddit permalink.

get_comments

Retrieve a bounded public comment tree from a Reddit permalink.

Configuration

Copy .env.example into your secret manager or MCP client configuration. Do not commit an .env file.

Variable

Required

Notes

REDDIT_CLIENT_ID

Yes

Approved OAuth client ID.

REDDIT_CLIENT_SECRET

Yes

Approved OAuth client secret.

REDDIT_USERNAME

Yes

Used in Reddit's required descriptive User-Agent.

REDDIT_ALLOWED_SUBREDDITS

No

* by default, or a comma-separated allowlist.

REDDIT_CACHE_TTL_SECONDS

No

Defaults to 900; capped at 3600.

REDDIT_REQUEST_INTERVAL_MS

No

Defaults to 1100; cannot be below 1000.

Install from source

npm ci
npm run check
npm run build

Codex

codex mcp add reddit-readonly \
  --env REDDIT_CLIENT_ID=... \
  --env REDDIT_CLIENT_SECRET=... \
  --env REDDIT_USERNAME=... \
  --env REDDIT_ALLOWED_SUBREDDITS='*' \
  -- node /absolute/path/to/reddit-readonly-mcp/dist/index.js

Claude Code

claude mcp add --transport stdio reddit-readonly -s user \
  --env REDDIT_CLIENT_ID=... \
  --env REDDIT_CLIENT_SECRET=... \
  --env REDDIT_USERNAME=... \
  --env REDDIT_ALLOWED_SUBREDDITS='*' \
  -- node /absolute/path/to/reddit-readonly-mcp/dist/index.js

Docker

docker build -t reddit-readonly-mcp .
docker run --rm -i \
  --env-file /path/to/private/reddit.env \
  reddit-readonly-mcp

Development

npm run typecheck
npm test
npm run build

Network integration tests are intentionally absent until approved Reddit credentials are available. Unit tests cover policy boundaries such as URL parsing, optional allowlists, cache limits, and response shaping.

Prior art

The tool naming and local MCP ergonomics were informed by the MIT-licensed reddit-mcp-buddy. This project uses an independent implementation and deliberately omits anonymous access, password grants, user analysis, and all write functionality.

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Reddit MCP Server

    liuyang1520
    A
    license
    B
    quality
    D
    maintenance
    Provides access to Reddit's API for retrieving posts, comments, user information, and search functionality. Supports multiple authentication methods and comprehensive Reddit data operations including subreddit browsing, post retrieval, and user profile access.
    Last updated
    9
    541
    1
    MIT

  • Reddit MCP Tool

    GeLi2001
    A
    license
    A
    quality
    D
    maintenance
    Enables browsing and searching Reddit content through read-only tools that access Reddit's official API. Supports searching posts, retrieving subreddit information, fetching hot posts, and getting detailed post information.
    Last updated
    5
    4
    MIT

  • Reddit MCP Server

    tandat8503
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with Reddit through a comprehensive API interface supporting both read-only operations (browsing posts, comments, user profiles) and authenticated actions (posting, commenting, voting) via OAuth2 authentication.
    Last updated
    7

  • Reddit MCP Server

    sumitroyyy
    F
    license
    -
    quality
    D
    maintenance
    Provides AI assistants with read-only access to Reddit's API for browsing subreddits, reading posts and comments, searching Reddit, and retrieving user/subreddit information. Enables safe exploration of Reddit content without posting capabilities through natural language interactions.
    Last updated

View all related MCP servers

Related MCP Connectors

  • BigVik193-reddit-user-mcp

    Browse and manage Reddit posts, comments, and threads. Fetch user activity, explore hot/new/rising…

  • Reddit

    Reddit MCP — public Reddit data via JSON endpoints (no auth required)

  • reddit

    Reddit posts, comments, subreddits, and search for AI agents. Free key, self-minted, no signup.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MufanQiu/reddit-readonly-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server