Reddit MCP Publisher

Reddit MCP Publisher

[CI] [npm] [MCP Registry] [MIT]

A self-hosted Reddit MCP server for AI agents that can read Reddit, preview drafts and publish with your approval. Connect Codex, Claude Desktop, OpenCode or another MCP client to your own Reddit session. Read posts, threads, subreddit rules, inbox notifications and Reddit Chat; prepare posts, comments or DMs.

The core browser workflow uses no Reddit developer API key. You still need your own Reddit sign-in in Chrome/Chromium. LightPanda is optional for supported authenticated reads, while Chrome handles login, previews and publishing.

Quick start

Requires Node.js 22+, npm and Chrome/Chromium.

npx -y reddit-mcp-publisher setup

For a specific MCP client:

npx -y reddit-mcp-publisher setup --client codexnpx -y reddit-mcp-publisher setup --client claude

Setup creates local MCP configuration and preserves existing browser profiles and encryption keys. Your Reddit password and cookies remain in your browser. Read the installation guide for desktops and headless servers.

[Illustrated workflow: read Reddit, preview a draft, approve the exact change, publish]

What it can do

Reddit's moderation and automation rules still apply. Publishing may fail, and subreddit moderators can remove a post afterward. A changed browser UI or an authentication challenge can stop an operation.

Real browser preview

[Cropped real Reddit browser preview for an unpublished r/test example]

Maintainer test on 2 November 2026: the form was filled, but no post was sent. Reproduction steps and limits.

Here is an illustrative terminal sequence. Replace placeholders with identifiers returned by the CLI:

reddit-mcp-publisher reddit-preflight testreddit-mcp-publisher prepare reddit-post --subreddit test --title "A tool for reviewing Reddit drafts" --body "I built a self-hosted tool. Feedback welcome."reddit-mcp-publisher preview <draft-id>

After inspecting the preview and deciding to publish:

reddit-mcp-publisher approve <draft-id> --digest <preview-sha256>reddit-mcp-publisher publish <draft-id> --approval <approval-token>

The publisher records publication status and the permalink when Reddit confirms submission. Approval is tied to a specific draft and destination.

Browser MCP vs Reddit API tools

Reddit MCP Publisher operates through an authenticated browser session to handle surfaces such as Reddit Chat, notifications and the live posting composer. An API-based Reddit integration typically uses developer credentials and has a different set of supported endpoints and limits. Both must respect Reddit rules. The project is local/self-hosted: there is no public hosted account connection.

Docs and support

• Product overview · FAQ: Reddit MCP without an API key
• Install for Claude, Codex, VPS · Browser modes
• Features and MCP tools · ChatGPT Actions
• Maintainer demo · Migration notes
• npm and MCP Registry release guide · Directory listing status
• Contributing · Security · Changelog

Please report bugs or share a reproducible use case. Independent user reports are tracked in Showcase. No external adoption or endorsements are claimed.

MIT licensed. Not affiliated with Reddit.