06ketan/substack-ops

> **Standalone Substack CLI + 26-tool MCP server for Cursor MCP, Claude MCP, OpenCode MCP, and any stdio MCP host. Your IDE drafts the replies. Zero AI API keys.**
Site → **substack-ops.chavan.in** · Source → **06ketan/substack-ops** · Glama → **mcp/servers/06ketan/substack-ops**
Posts, notes, comments, replies, reactions, restacks, recommendations, search,
profiles, feeds, automations, MCP server, Textual TUI. One Python install, one
binary, MIT licensed.
TL;DR — MCP-native (no API key, one command)
Your **host's** LLM (Cursor's, Claude's) does the drafting via the
propose_reply / confirm_reply tools. No ANTHROPIC_API_KEY /
OPENAI_API_KEY needed.
Wrong install?
This project is **substack-ops on PyPI** — install with **uv / uvx**, not unrelated **npx** packages that appear when searching “Substack MCP”. Canonical listing: **Glama — 06ketan/substack-ops**.
Works with (MCP)
These rows help discovery (search keywords); **confirm each host’s current MCP docs** before upgrading.
Open source–oriented hosts
| Host | Documentation | Typical wire-up |
|------|---------------|-----------------|
| **OpenCode** | OpenCode MCP servers | uvx substack-ops mcp install opencode |
| **Continue** | Continue | uvx substack-ops mcp install print — paste the snippet into Continue’s MCP settings |
| **Zed** | Zed | Configure stdio MCP per Zed’s docs |
| **Cline** | Cline | MCP setup per extension / marketplace docs |
| **Goose** | Goose | MCP extensions per Goose docs |
Large commercial stacks
| Host | Documentation | Typical wire-up |
|------|---------------|-----------------|
| **Cursor** | Cursor MCP | uvx substack-ops mcp install cursor |
| **Claude** (Desktop / Code) | Claude Desktop, Claude Code | mcp install claude-desktop / claude-code |
| **GitHub Copilot** | Copilot | MCP in VS Code / Copilot where supported — use print + host docs |
| **ChatGPT** | OpenAI | Developer / connector flows — often REST (Slideshot API) for tools without MCP |
| **Google Gemini** | Gemini | Gemini CLI / IDE features per Google docs — stdio where supported |
OpenCode (copy-paste)
Auto-install:
Manual (~/.config/opencode/opencode.json):
Optional version pin: use ["uvx", "substack-ops==0.3.5", "mcp", "serve"] (replace with current PyPI release).
Setup (dev / from source)
Auth defaults to ~/.cursor/mcp.json's mcpServers.substack-api.env. Override
with env or .env. Or use one of the auth flows in auth login / auth setup.
Command surface
Grouped by intent. Every write defaults to --dry-run; flip with
--no-dry-run (and --yes-i-mean-it for the irreversible ones). All writes
land in .cache/audit.jsonl and are dedup-checked against .cache/actions.db.
Auth (4)
| Command | What it does |
|---|---|
| auth verify | Confirm the cookie works; print authed user/pub. |
| auth test | Same as verify, exit non-zero on failure (CI-friendly). |
| auth login --browser chrome\|brave | Auto-grab cookie from local Chromium browser via macOS Keychain. |
| auth login --email me@x.com | Email magic-link → paste-the-link interactive flow. |
| auth setup | Interactive paste of connect.sid cookie. |
Read — Posts (8)
| Command | What it does |
|---|---|
| posts list [--pub] [--limit] [--sort new\|top] | List posts from a publication (yours by default). |
| posts show [--pub] | Post metadata (title, dates, reactions, comment count). |
| posts get --slug [--pub] | Same as show but slug-only. |
| posts content [--md] [--pub] | HTML body (auth-aware for paywalled). --md converts to Markdown. |
| posts stats | Engagement counts — reactions, comments. |
| posts search [--pub] [--limit] | Substack-side full-text search. |
| posts paywalled [--pub] | Boolean: is this post paywalled? |
| posts react [--off] [--pub] | Add (or remove with --off) a reaction. Defaults to ❤. |
| posts restack [--off] | Restack a post (Substack does not support unrestack). |
Read — Notes (5)
| Command | What it does |
|---|---|