CLI & MCP
Your vault is just markdown files on disk. The brainstormd command line and the built-in MCP server let Claude — and your terminal — read and edit those files directly. Every change syncs to your other devices like any other edit.
Use it from Claude
Open Settings → CLI & MCP in the desktop app and click Enable for Claude Code, Claude Desktop, or Codex. Restart the client and ask it to work with your notes — no config files, no API keys for the vault itself.
Prefer the command line? Register it directly:
-- brainstormd mcp
Install the CLI
One click in Settings → CLI & MCP → Install adds brainstormd (and the short alias bmd) to your PATH. No Node install needed. It targets whatever vault you have open — or pass --vault / BRAINSTORMD_VAULT.
Commands
Add --json to any command for machine-readable output. A body/text argument of - reads stdin.
| brainstormd list | List notes (newest first) |
| brainstormd read <path> | Print a note |
| brainstormd search "<query>" | Full-text search |
| brainstormd create <path> | Create a note |
| brainstormd append <path> "<text>" | Append (also reads piped stdin) |
| brainstormd replace <path> --find a --replace b | Find & replace |
| brainstormd move <path> <to> | Rename / move |
| brainstormd toggle <path> --line N | Flip a task checkbox |
| brainstormd delete <path> --yes | Delete a note |
| brainstormd mcp | Run the MCP server |
macOS and Linux today; Windows support is on the way.