Bragproof

← Reports

mac-voice-mcp

Starts with no setup0.10.0npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Contacts while installing and starting: nothing

6tools listed
0hosts contacted
0files written
0.1 sto start
1dependencies

Its tool definitions changed since version 0.9.0. If you approved the earlier ones, read them again.

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y -p mac-voice-mcp@0.10.0 mac-voice-mcp

Installing a package runs its code. Use a sandbox for anything you have not read.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

speak_and_listen text_to_speak, listen_seconds, listen
Say something out loud to the user and hear their spoken reply.
Speaks text_to_speak through the computer's speakers, then listens like a conversation turn — it waits for
the user to start talking and stops when they finish — and returns an on-device transcript of what they said.

Write text_to_speak for the ear, not the screen:
- 1–3 short sentences, under ~40 words; lead with the outcome, then one question.
- Plain words only: no markdown, bullets, emoji, code, file paths, URLs, stack traces or tables.
- Describe code instead of reading it ("I added a retry to the upload function"), say file names
  not paths ("in index.ts"), round numbers ("about two hundred ms"), spell out symbols.
- Ask one question at a time, answerable in a few words ("Should I deploy it — yes or no?").
- Put the details (diffs, logs, links) in your normal on-screen reply, and say so out loud.
- Tool output (Bash stdout, file writes) is NOT the on-screen reply. Only your own assistant message text renders.
- A spoken turn with no assistant message text shows the user nothing — never skip the on-screen reply.

Good: "The build passed and all tests are green. Want me to open the pull request?"
Bad: "## Results\n- `npm test` ✅ 42/42\n- see /Users/x/repo/src/index.ts:120"

Once the user is talking with you by voice, keep the conversation in voice: answer each transcript with
another speak_and_listen call (not a text reply) until they say stop or start typing.
To end voice mode, or for a one-way announcement, pass listen: false: it returns at once and speaks while you work.
A reply of "(No speech detected …)" means the user did not answer — never treat it as consent. Ask once more;
if still nothing, stop and say on screen that voice mode is paused and they can type to carry on (not speak: the mic is off).
The "voice-mcp timing" line at the end is diagnostics: ignore it unless the user asks why things feel slow.
If it reports that voice-mcp is not set up, call voice_setup.
call action
Start or end a call: a hands-free session where the microphone stays open and the user talks whenever they
like, like a phone call, until they hang up. action start takes the speaker and microphone and returns the
rules of the call; it says nothing aloud, so greet the user yourself, once, in a few words, with say, then call
listen. action end hangs up (also happens when the user says "hang up" or "bye Claude", or after a long
silence). During the call, speak with say and hear the user with listen.
say text
During a call: say text out loud and return at once, so you carry on working while it plays.
The result includes anything the user said meanwhile. Only during a call: use speak_and_listen otherwise.

Write text for the ear, not the screen:
- 1–3 short sentences, under ~40 words; lead with the outcome, then one question.
- Plain words only: no markdown, bullets, emoji, code, file paths, URLs, stack traces or tables.
- Describe code instead of reading it ("I added a retry to the upload function"), say file names
  not paths ("in index.ts"), round numbers ("about two hundred ms"), spell out symbols.
- Ask one question at a time, answerable in a few words ("Should I deploy it — yes or no?").
- Put the details (diffs, logs, links) in your normal on-screen reply, and say so out loud.
- Tool output (Bash stdout, file writes) is NOT the on-screen reply. Only your own assistant message text renders.
- A spoken turn with no assistant message text shows the user nothing — never skip the on-screen reply.
listen wait_seconds
During a call: return what the user has said since you last heard from them, at once if something is waiting,
otherwise wait up to wait_seconds (default and maximum 40) for their next words.
"(still on the call, nothing said)" means nobody spoke yet: call listen again to keep waiting, or say something.
Once it reports that the call ended, don't call it again.
flag note
Call only when the user explicitly asks to flag or report a bad voice turn; never on your own. Saves the last minute of what voice-mcp did (levels, why turns ended, whether speech finished: no transcripts) to a local file. Only works when the user turned the flight recorder on. Returns the file's path.
voice_setup install, kokoro, bubble
Check whether this computer has everything speak_and_listen needs — text-to-speech, a microphone recorder (SoX),
whisper.cpp speech-to-text and the speech model — and optionally install what's missing.
Anything already installed is reused (an existing model elsewhere on disk is symlinked, not re-downloaded).
Call it with install=false (the default) first and tell the user what is missing.
Only call it with install=true after the user agrees: it runs `brew install` for the missing packages
and downloads the speech model once. It never uninstalls or changes anything else.
kokoro=true (also only after the user agrees) installs the optional Kokoro voice: more natural than the built-in one,
runs on this Mac, about 1 GB on disk. Once installed it's used automatically; the built-in voice stays as the fallback.
bubble=true (also only after the user agrees) builds the floating call bubble on this Mac with swiftc: a small window during calls with mute and hang up.
If it reports INSTALLING, the install continues in the background — wait a minute and call it again to check.

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseMIT
Needsnode >=22
Sourcegithub.com/jeet0007/mac-voice-mcp
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-fp2WtCU4nZoRbUmjmZ5MfBMqJY0B9IpatbBR7OX28n+9mAjtG/o85q/cCdsXjILvp9Qf1n2cMN1jaAu7XhtlDw==

Versions reported

VersionRunResultTools
0.10.02026-11-16Starts with no setup6
0.9.02026-11-12Starts with no setup5

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/mac-voice-mcp.svg)](https://bragproof.smaverk.com/r/mac-voice-mcp)

New version out? Ask for a fresh report.