§ CLI · REST · MCP
Developer surface
Three front doors over a single Unix-socket IPC. The bundled `dettivo` CLI, a token-gated REST shim on 127.0.0.1, and a stdio MCP server you can drop into Claude Code, Cursor, or Codex with one config line.
Use case · Claude Code
Claude Code + Dettivo MCP
Run `dettivo mcp config --host claude-desktop --write` (Claude Code reads the same MCP server config). Restart Claude Code. The agent now has tools to search your 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`. The Codex CLI now has MCP tools to search your transcripts, drive dictation, and insert text. No extension or wrapper required.
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 --write` to drop the config into your agent host. 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 transcripts latest --format markdown` is one line of bash; wrap it in a Raycast script and you have an instant "latest transcript" hotkey.
REST
REST API
A loopback HTTP adapter on 127.0.0.1:45831. Off by default. Enable in Settings › Developer 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-first defaults, 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.