# StackCLI

> A macOS menubar app for scheduling Substack Notes from the terminal, Claude Desktop, or Claude Code.

StackCLI lets Substack writers schedule short-form Notes (not full newsletter posts) from their terminal or AI assistant. Notes are submitted to Substack as scheduled drafts within ~60 seconds — Substack handles the actual publication timing.

## Key Facts

- macOS 15+ menubar app
- Free and open-source
- Interfaces: CLI (`stackcli`), Claude Desktop (MCP), Claude Code (MCP)
- Schedules Substack Notes specifically (short-form feed posts)
- Notes go to Substack as scheduled drafts immediately, not held locally

## How It Works

1. Add a note via CLI (`stackcli add "content" --when morning`) or MCP tools
2. Note saved locally as a pending markdown file
3. Menubar app polls every 60s, submits to Substack as a scheduled draft
4. Substack publishes at the scheduled time
5. App archives the note locally after publication

## MCP Tools

StackCLI exposes tools via the Model Context Protocol for use in Claude Desktop and Claude Code:

- `list_notes` — List all notes in the queue with ID, status, time, preview
- `show_notes` — Show full content of all scheduled notes
- `add_note` — Add a note with optional schedule time (morning, afternoon, evening, tomorrow, now) and media attachments
- `edit_note` — Edit content or reschedule an existing note
- `delete_note` — Remove a note from the queue
- `search_notes` — Search notes by keyword across queue and archive
- `get_stats_summary` — Get posting stats: total notes, per-day breakdown, engagement metrics
- `refresh_stats` — Refresh engagement stats from Substack

## CLI Commands

- `stackcli add "content"` — Add a note
- `stackcli add "content" --when morning` — Schedule for next morning slot
- `stackcli add "content" --at "2024-12-25 09:00"` — Schedule for exact time
- `stackcli list` — List pending notes
- `stackcli edit <id>` — Edit a note
- `stackcli delete <id>` — Remove a note
- `stackcli auth` — Authenticate with Substack

## Links

- Website: https://stackcli.dev
- Guide: https://stackcli.dev/guide
- Download: https://stackcli.dev/downloads/StackCLI.dmg