Guide

How to use StackCLI — from Claude Desktop, Claude Cowork, Claude Code, or the terminal.

Claude Desktop

Using StackCLI in Claude Desktop

StackCLI registers itself as an MCP server automatically when you first run the app. Nothing to configure manually.

1

Download and open StackCLI

The app lives in your menubar. On first launch it registers itself with Claude Desktop.

2

Restart Claude Desktop

One restart is needed to pick up the new MCP server.

3

Ask Claude to schedule a note

That's it. Claude can now queue, list, and remove notes on your behalf.

Claude Desktop
You
Schedule my note about writing habits for Friday morning
Claude
stackcli · schedule_note
Done — queued for Fri Apr 10 at 09:33. Draft saved to Substack, it'll publish automatically.
Claude Cowork

Using StackCLI in Claude Cowork

Claude Cowork uses the same MCP setup as Claude Desktop — once the app is installed, it works automatically.

Claude Cowork
You
Draft a short note about why consistent writers beat prolific ones, and queue it for Tuesday
Claude
stackcli · schedule_note
Queued for Tue Apr 08 at 10:12. Draft saved to Substack — it'll publish automatically.
Claude Code

Using StackCLI in Claude Code

Download and open StackCLI first — the app installs the MCP binary automatically. Then register it with Claude Code once:

$ claude mcp add stackcli ~/.subposter/bin/stackcli-mcp

After that, just ask Claude — it runs the CLI on your behalf and confirms once it's queued.

Claude Code
You
Queue a note saying the refactor is done, schedule it for tomorrow morning
Claude
$ stackcli add "The refactor is done." tomorrow
Queued for tomorrow at 08:47. Goes to Substack as a scheduled draft straight away.
Terminal

Using the CLI directly

Add a note with a time and StackCLI sends it to Substack as a scheduled draft straight away.

$ stackcli add "My note text" friday
✓ Queued · Fri Apr 11 09:12 · draft saved to Substack

The time hint goes after your note text — no flags needed. Supported keywords:

morning afternoon evening tonight tomorrow monday tuesday wednesday thursday friday saturday sunday

Day names always resolve to the next occurrence — if today is Friday, friday schedules for next Friday. StackCLI picks a slot within the day's window (08:00–21:00) and avoids crowding notes together.

You can also pass an exact time with --at:

$ stackcli add "My note" --at 2026-04-10T09:00

To see what's queued:

$ stackcli show