Automate PinMark Sticky desktop notes from the command line

The pinmark CLI gives scripts a stable way to work with the notes you keep visible on your Mac—without directly reading the database or taking over your screen.

Local by design. Commands are delivered to the PinMark app through local IPC. Mutations follow the same validation and Pro boundaries as actions in the app.

Install the command

Open Settings → General → Command Line and choose Install. Then check the whole connection, from the command to the running app:

pinmark doctor

Complete note workflow

Create notes from Markdown, a template, an image file, or the clipboard; choose the color and paper. Append, update, delete to Trash, restore, pin to or unpin from the desktop, and open. List and search with paging and filters, and read any note, including notes in the Trash.

printf '# Release checklist\n- [ ] Verify build' | pinmark create --from-file - pinmark templates pinmark create --template <template-id> --paper lined pinmark search "release" --limit 20 --offset 20 pinmark show <note-id> --format markdown pinmark append <note-id> --from-file - pinmark open <note-id>

Built for dependable automation

JSON output by default, stable for scripts; invalid options fail with a clear exit code before anything is sent.
Only open and --open bring PinMark to the front; every other command updates notes in the background without stealing focus.
Delete moves notes to Trash so they can be restored.
pinmark doctor pinpoints which step fails and how to fix it.

Connect an AI client

If your tool supports MCP, use the local MCP server instead of composing CLI calls yourself.