substack-ops

Name: substack-ops
Author: 06ketan

作者：06ketanバージョン 0.3.5i★ –iパソコンで動く

レジストリ名io.github.06ketan/substack-ops

インストール

概要

作者による説明（英語の原文）

Substack CLI + 26-tool MCP server. Your IDE drafts replies via propose_reply. No API keys.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: その他
入力が必要なもの：SUBSTACK_SESSION_TOKEN

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： SUBSTACK_PUBLICATION_URL, SUBSTACK_USER_ID, SUBSTACK_SESSION_TOKEN, SUBSTACK_OPS_MCP_PATH, SUBSTACK_OPS_LLM_CMD

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

PyPIPythonのuvのインストール（uvxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "substack-ops": {
      "command": "uvx",
      "args": [
        "substack-ops",
        "mcp",
        "serve"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "your-value",
        "SUBSTACK_USER_ID": "your-value",
        "SUBSTACK_SESSION_TOKEN": "your-value",
        "SUBSTACK_OPS_MCP_PATH": "your-value",
        "SUBSTACK_OPS_LLM_CMD": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add substack-ops --env SUBSTACK_PUBLICATION_URL=your-value --env SUBSTACK_USER_ID=your-value --env SUBSTACK_SESSION_TOKEN=your-value --env SUBSTACK_OPS_MCP_PATH=your-value --env SUBSTACK_OPS_LLM_CMD=your-value -- uvx substack-ops mcp serve

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "substack-ops": {
      "command": "uvx",
      "args": [
        "substack-ops",
        "mcp",
        "serve"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "your-value",
        "SUBSTACK_USER_ID": "your-value",
        "SUBSTACK_SESSION_TOKEN": "your-value",
        "SUBSTACK_OPS_MCP_PATH": "your-value",
        "SUBSTACK_OPS_LLM_CMD": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "substack-ops": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "substack-ops",
        "mcp",
        "serve"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "your-value",
        "SUBSTACK_USER_ID": "your-value",
        "SUBSTACK_SESSION_TOKEN": "your-value",
        "SUBSTACK_OPS_MCP_PATH": "your-value",
        "SUBSTACK_OPS_LLM_CMD": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

SUBSTACK_PUBLICATION_URL env
Your Substack publication URL (e.g. https://you.substack.com/). Optional if set in ~/.cursor/mcp.json's mcpServers.substack-api.env.
SUBSTACK_USER_ID env
Your Substack numeric user id. Optional if set in ~/.cursor/mcp.json.
SUBSTACK_SESSION_TOKEN 秘密 env
Your Substack session cookie value (the s%3A... string). Required for authenticated calls. Easier path: run `substack-ops auth login --browser chrome` and the cookie is auto-grabbed.
SUBSTACK_OPS_MCP_PATH env
Override path to the mcp.json file the auth layer reads. Defaults to ~/.cursor/mcp.json.
SUBSTACK_OPS_LLM_CMD env
Optional: override the host CLI used by the unattended daemon path (default: auto-detect claude / cursor-agent / codex on PATH). Use {prompt} placeholder if your CLI takes the prompt as an arg.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月6日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント 06ketan で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

このカテゴリのほかの32424件のうち0%よりスターが多い
このカテゴリのほかの32424件のうち8%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの32424件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

substack-opsは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：SUBSTACK_SESSION_TOKEN

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.3.5）がレジストリに届いたのは6 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは？

同じカテゴリには：Spec Driven Development, Remote Desktop Commander, BankBridge

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

パソコンで動く★ 440MIT14 か月前更新

インストール

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

クラウドで動く★ 211昨日更新

インストール

BankBridge

作者：bankbridge-money

Works in any MCP agent, including local models. Read-only bank accounts, spending, investments.

クラウドで動く今日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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](https://substack-ops.chavan.in) · Source → [06ketan/substack-ops](https://github.com/06ketan/substack-ops) · Glama → [mcp/servers/06ketan/substack-ops](https://glama.ai/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)

uvx substack-ops mcp install cursor          # or claude-desktop, claude-code, opencode, print

Restart your host. Then in chat:

"list unanswered comments on post 193866852"

"draft a warm reply to comment 12345"

"post that draft"

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](https://pypi.org/project/substack-ops/) — install with `uv` / `uvx`, not unrelated `npx` packages that appear when searching “Substack MCP”. Canonical listing: [Glama — 06ketan/substack-ops](https://glama.ai/mcp/servers/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:

uvx substack-ops mcp install opencode

Manual (~/.config/opencode/opencode.json):

"mcp": { "substack-ops": { "type": "local", "command": ["uvx", "substack-ops", "mcp", "serve"], "enabled": true } } }

Optional version pin: use ["uvx", "substack-ops==0.3.5", "mcp", "serve"] (replace with current PyPI release).

Setup (dev / from source)

git clone https://github.com/06ketan/substack-ops && cd substack-ops

uv sync uv sync --extra mcp # mcp SDK for the MCP server (recommended) uv sync --extra tui # textual for the TUI uv sync --extra chrome # pycryptodome + keyring for Chrome cookie auto-grab

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.

uv run substack-ops auth verify

uv run substack-ops quickstart # 20-step tour

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
`notes list [--limit]`	Your published Notes.
`notes show`	One note + its reply tree.
`notes publish [--no-dry-run]`	Publish a top-level Note.
`notes react [--off]`	React on any Note.
`notes restack [--off]`	Restack a Note.

Read + Write — Comments (5)

Command	What it does
`comments tree [--pub]`	Full nested comment tree as table.
`comments export --out file.json [--pub]`	Same tree as JSON.
`comments add [--pub] [--no-dry-run]`	New top-level comment.
`comments react --kind post\	note [--off]`	React on a comment.
`comments delete --kind post\	note [--no-dry-run]`	Destructive — your own comments only.

Reply engine (6)

Command	What it does
`reply template --template thanks`	Rule-based replies (no LLM).
`reply review`	LLM drafts each, you `[a]ccept / [e]dit / [s]kip / [q]uit`.
`reply bulk --out drafts.json`	Draft every comment to a file. Edit, set `action: "approved"`.
`reply note-bulk --out drafts.json`	Same for replies under a Note.
`reply bulk-send drafts.json [--no-dry-run]`	Posts only `approved` rows. Dedup-checked.
`reply auto --no-dry-run --yes-i-mean-it`	Draft + post immediately. 30s rate limit.

Read — Discovery (8)

Command	What it does
`feed list --tab for-you\	subscribed\	category-{slug}`	Reader feed (the Substack app feed).
`profile me` / `profile get`	Profile.
`users get` / `users subscriptions`	Public user info + their subs.
`podcasts list [--pub]`	Audio posts.
`recommendations list [--pub]`	Pub's recommended publications.
`authors list [--pub]`	Pub's contributor list.
`categories list` / `categories get --name`	Substack's category taxonomy.

Automations (3)

Command	What it does
`auto presets`	List built-in YAML rules.
`auto run`	One-shot run a preset.
`auto daemon --interval 60`	Loop forever; logs to audit.

Operations + safety (3)

Command	What it does
`audit search [--kind] [--target] [--status] [--since 7d]`	Query the JSONL audit log.
`audit dedup-status`	Counts in the dedup SQLite DB.
`quickstart`	20-step interactive tour.

MCP server (3)

Command	What it does
`mcp install [--dry-run]`	Auto-merge config into your host.
`mcp serve`	stdio MCP server (26 tools).
`mcp list-tools`	Print the tool registry.

Other (1)

Command	What it does
`tui`	Textual TUI — 6 tabs (Notes, Posts, Comments, Feed, Auto, Profile).

Multi-publication

Every read command accepts --pub . Defaults to your own publication.

substack-ops posts list --pub stratechery --limit 5

substack-ops posts search "ai" --pub stratechery substack-ops recommendations list --pub stratechery

Reply modes

Mode	What it does	Safety
`template`	YAML keyword/regex rules under `src/substack_ops/templates/*.yaml`	dry-run default
`review`	LLM drafts each reply, you `[a]ccept / [e]dit / [s]kip / [q]uit`	dry-run default + manual gate per comment
`bulk`	LLM drafts every comment to `drafts.json`. Edit file, set `action: "approved"`	offline review, dedup-checked on send
`bulk-send`	Posts only items with `action: "approved"`	dry-run default; dedup DB prevents the M2 31-dup-replies regression
`auto`	LLM drafts and posts immediately	requires `--no-dry-run --yes-i-mean-it`, 30s rate limit

After every live note-reply the engine re-fetches the new comment and asserts ancestor_path is non-empty. If empty, the audit row's result_status is flipped to "orphaned" (the M2 bug where parent_comment_id was silently dropped — now caught).

Automations

Built-in presets (auto presets):

like-back — when someone reacts to your note, react to their latest note.
auto-reply — same trigger, but post a templated thank-you.
auto-restack — when a watchlist handle posts a new note, restack it.
follow-back — when someone follows you, follow them back.

Custom YAML rules under ~/.config/substack-ops/auto/*.yaml. Loop with auto daemon --interval 60.

MCP server

substack-ops mcp install opencode          # auto-add to ~/.config/opencode/opencode.json

substack-ops mcp install cursor # auto-add to ~/.cursor/mcp.json substack-ops mcp install claude-desktop # auto-add to claude_desktop_config.json substack-ops mcp install claude-code

冒頭だけを表示しています。続きはリポジトリで読めます

substack-ops

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

Spec Driven Development

Remote Desktop Commander

BankBridge

作者のREADME

substack-ops

TL;DR — MCP-native (no API key, one command)

Restart your host. Then in chat:

"list unanswered comments on post 193866852"

"draft a warm reply to comment 12345"

"post that draft"

Wrong install?

Works with (MCP)

Open source–oriented hosts

Large commercial stacks

OpenCode (copy-paste)

Setup (dev / from source)

Command surface

Auth (4)

Read — Posts (8)

Read — Notes (5)

Read + Write — Comments (5)

Reply engine (6)

Read — Discovery (8)

Automations (3)

Operations + safety (3)

MCP server (3)

Other (1)

Multi-publication

Reply modes

Automations

MCP server