Transcribe a local audio file and return the transcript.

IMPORTANT: path must be a file on the user's Mac filesystem inside the configured allow-list (typically ~/Desktop or ~/Downloads). Files uploaded to the Claude chat window are NOT accessible — ask the user to save the file to their Desktop or Downloads folder first.

If this tool returns an access-denied error, do NOT attempt to transcribe the file by any other means (e.g. downloading a model, calling an external API, or using in-process speech recognition). Simply tell the user to save the file locally and retry with this tool.

Cancel the currently running transcription, if any.

Return the transcription models available across all engines.

MacWhisper entries are formatted as engine:model-id — Display Name [active] where [active] marks the model currently selected in MacWhisper; pass the engine:model-id string as model with the default engine="macwhisper". whisper-cpp entries (if MACWHISPER_WHISPERCPP_MODEL_DIR is configured) are formatted as filename [whisper-cpp]; pass the filename as model with engine="whisper-cpp". Requires the MacWhisper CLI to be reachable even if you only intend to use the whisper-cpp engine.

Return the directories this server is allowed to read audio from.

Start watching a folder for new audio files to auto-transcribe.

New audio files dropped into folder are transcribed automatically and moved to a "done" directory. By default this is <folder>/../done; override it with the MACWHISPER_WATCH_DONE_DIR env var. Both the incoming folder and the done directory must be inside the configured allow-list, otherwise the call is rejected. Call get_watch_results() to retrieve completed transcriptions.

Stop the active folder watcher.

Return completed watch-folder transcriptions and clear the queue.

Each entry contains: file, transcript, destination, error.