Skip to main content
The superwhisper CLI gives you terminal access to your local transcription history, vocabulary, and snippets. It can also run as an MCP (Model Context Protocol) server, so AI assistants like Claude Code can search and read your dictations. The superwhisper CLI showing its command list and the output of superwhisper stats
The CLI is available on macOS and reads the same local database as the app; its commands run entirely on your device. If you connect an AI assistant over MCP, the transcripts it queries are sent to that assistant and handled under its own model and data settings.

​
Install

The script installs the latest release to /usr/local/bin, or to ~/.local/bin if that isn’t writable. Binaries and checksums are published at superultrainc/superwhisper-cli-release.

​
Commands

Examples:
Most commands accept --json for machine-readable output. Point the CLI at a non-default install with --db <path> (or SUPERWHISPER_DB) and --settings <path> (or SUPERWHISPER_SETTINGS).

​
MCP server

Run the CLI as an MCP server to give AI assistants read access to your history and control over vocabulary and snippets:
The server speaks MCP over stdio and exposes tools for search, history, reading recordings, modes, stats, vocabulary, and snippets. To add it to Claude Code manually:
If you connect Claude Code through the coding agent integration, the MCP server is set up for you.