# io.github.jeet0007/mac-voice-mcp (npm · mac-voice-mcp)

Talk with your AI assistant out loud on a Mac, with on-device speech recognition (whisper.cpp).

- Trust score: 84/100 (high trust)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-30

## Components

- npm · `mac-voice-mcp`: 84/100 (this document), [markdown](https://verifymcp.io/servers/jeet0007-mac-voice-mcp/mac-voice-mcp.md), [page](https://verifymcp.io/servers/jeet0007-mac-voice-mcp/mac-voice-mcp)

## Channel facts

- Registry: `npm`
- Package: `mac-voice-mcp`
- Version: `0.3.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-30.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 92 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to jeet0007/mac-voice-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 77/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1231 tokens (~615/item across 2 items; 2 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 2 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 3 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the io.github.jeet0007/mac-voice-mcp server?

io.github.jeet0007/mac-voice-mcp runs locally as an npm package, launched with npx -y mac-voice-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add jeet0007-mac-voice-mcp -- npx -y mac-voice-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "jeet0007-mac-voice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "jeet0007-mac-voice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add jeet0007-mac-voice-mcp -- npx -y mac-voice-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jeet0007-mac-voice-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mac-voice-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add jeet0007-mac-voice-mcp --command npx --arg -y --arg mac-voice-mcp
```

### Hermes

```yaml
mcp_servers:
  jeet0007-mac-voice-mcp:
    command: "npx"
    args: ["-y", "mac-voice-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "jeet0007-mac-voice-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add jeet0007-mac-voice-mcp -t stdio -c npx -a -y mac-voice-mcp
```

### Other

```json
{
  "mcpServers": {
    "jeet0007-mac-voice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-30 (score 84, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-09-29 (score 69, 0)

- [security improvement] Malware scan: unverified → pass
- [functional] Package version: 0.3.0 → 0.3.1

### 2026-09-28 (score 69, −12)

- [security regression] Malware scan: pass → unverified
- [security regression] Known CVEs: pass → unverified
- [security regression] Tool safety: pass → unverified
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Schema quality: 554 → 615
- [functional regression] Capabilities: pass → unverified
- [functional regression] Dependency health: 0.85 → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional improvement] Stability: unverified → 0.17
- [functional] Package version: 0.1.1 → 0.3.0
- [functional] Package version: 0.1.1 → 0.2.0
- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-25 (score 81, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-23 (score 81)

First indexed and scored.

## MCP tools (2)

### `speak_and_listen` (~579 tokens)

Speak and 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 speaks without opening the mic.
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.

Input parameters:

- `listen` (boolean): Default true. false: only speak, without opening the microphone — for a one-way announcement, or to say goodbye when the user ends voice mode.
- `listen_seconds` (number): Upper limit on how long to listen, in seconds (default 30, max 120). Listening already stops when the user finishes talking, so you rarely need this.
- `text_to_speak` (string, required): The summary or message to read aloud to the user. Plain, conversational text.

### `voice_setup` (~180 tokens)

Voice setup

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.
If it reports INSTALLING, the install continues in the background — wait a minute and call it again to check.

Input parameters:

- `install` (boolean): false (default): only check. true: brew install missing packages and download the model. Ask the user first.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/jeet0007-mac-voice-mcp/mac-voice-mcp#diagnostics

## Score history

- 2026-09-30: 84
- 2026-09-29: 69
- 2026-09-28: 69
- 2026-09-27: 81
- 2026-09-26: 81
- 2026-09-25: 81
- 2026-09-24: 81
- 2026-09-23: 81

## Common questions

### What is the io.github.jeet0007/mac-voice-mcp server?

io.github.jeet0007/mac-voice-mcp is listed in the public MCP registry as io.github.jeet0007/mac-voice-mcp. Talk with your AI assistant out loud on a Mac, with on-device speech recognition (whisper.cpp). This page covers its npm package (mac-voice-mcp).

### Is the io.github.jeet0007/mac-voice-mcp server safe to use?

io.github.jeet0007/mac-voice-mcp scores 84 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 30 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.jeet0007/mac-voice-mcp server expose?

io.github.jeet0007/mac-voice-mcp exposes 2 tools: speak_and_listen, voice_setup. Their descriptions and schemas cost roughly 759 tokens of context every time the server is loaded.

### Is the io.github.jeet0007/mac-voice-mcp server still maintained?

io.github.jeet0007/mac-voice-mcp is still listed as active in the MCP registry. We last reached this channel on 30 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the io.github.jeet0007/mac-voice-mcp server under?

io.github.jeet0007/mac-voice-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/mac-voice-mcp
- Socket report: https://socket.dev/npm/package/mac-voice-mcp
- Repository: https://github.com/jeet0007/mac-voice-mcp
- Changelog RSS feed: https://verifymcp.io/servers/jeet0007-mac-voice-mcp/mac-voice-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/jeet0007-mac-voice-mcp/mac-voice-mcp.json
- HTML version of this page: https://verifymcp.io/servers/jeet0007-mac-voice-mcp/mac-voice-mcp
