§ CLI · REST · MCP
Developer surface
The bundled `dettivo` CLI, token-gated REST shim on 127.0.0.1, and stdio MCP server expose the same local speech memory to scripts and agents.
Use case · Claude Code
Claude Code + Dettivo MCP
Install the Dettivo CLI, then add the local stdio server with `claude mcp add --transport stdio dettivo -- dettivo mcp serve`. Your Mac now exposes local speech memory to the agent: search transcripts, start dictation, import audio, and insert into the focused app.
CLI
CLI reference
Dettivo ships a bundled CLI named `dettivo`. Run `dettivo install-helper --link` to symlink it into `~/.local/bin/`. The CLI exposes dictation, meeting, transcript, import, polish, and MCP commands over the same IPC the app uses.
Developer toolLocal-onlyUse case · Codex
Codex CLI + Dettivo MCP
Run `dettivo mcp config --host codex --write`. Dettivo writes the Codex MCP stanza to `$CODEX_HOME/config.toml` or `~/.codex/config.toml`, then Codex can search your local transcripts, drive dictation, and insert text.
Developer API
Developer API overview
Dettivo exposes a single IPC contract over a Unix socket. Three surfaces consume it: the bundled `dettivo` CLI, a loopback REST adapter on 127.0.0.1:45831, and a stdio MCP server. Everything one can do, the others can do.
Developer toolMCP
MCP server
Dettivo ships a stdio MCP server. Run `dettivo mcp serve` or use `dettivo mcp config --host claude-desktop|cursor|codex` to generate host config. `--write` is supported for Claude Desktop and Codex. Tools and resources let coding agents read transcripts, start sessions, and insert text into the focused app.
Developer toolUse case · Raycast
Raycast workflows with Dettivo
Use the Dettivo CLI inside Raycast script commands. `dettivo --json transcript latest` gives you the newest transcript reference; `dettivo transcript export --kind <kind> --id <uuid> --format md --out <file>` writes markdown for follow-on actions.
REST
REST API
A loopback HTTP adapter on 127.0.0.1:45831. Off by default. Enable in Settings › REST API. Bearer token required. Maps every IPC operation to a JSON HTTP endpoint. Streaming import/export endpoints for long jobs.
Developer toolOpt-inLocal-only
- Getting started Install, activate, grant permissions, and run your first dictation.
- Dictation Hotkeys, modes, direct insertion, dictionary, Quick Access, Quick Note.
- Meetings Bot-free capture, speaker labels, meeting analysis, recap automation, Meeting Mirror.
- Automation Dictation macros, app + shell allowlists, recap email automation, weekly digest.
- Privacy + security Local models, BYOK providers, telemetry policy, permissions, retention.
- Account + license Activation, device management, secure updates, recovery, refunds.
- Troubleshooting Hotkeys, insertion, meeting audio, MCP connect, REST 401, license activation.