Automate 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 PinMark Settings → Command Line and choose Install. Confirm the connection:

pinmark ping --no-activate pinmark status --json

Complete note workflow

Create, append, update, delete to Trash, restore, pin, unpin, list, search, show, open, and ping. Use Markdown directly or pipe content from another tool.

printf '# Release checklist\n- [ ] Verify build' | pinmark create --from-file - pinmark search "release" --json pinmark append <note-id> --from-file - --no-activate pinmark open <note-id>

Built for dependable automation

--json produces stable machine-readable output.
--no-activate lets background jobs update notes without stealing focus.
Delete moves notes to Trash so they can be restored.
Explicit open actions still bring the requested note forward.

Connect an AI client

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

Set up PinMark MCP →