voicevox-assistant-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
voicevox-assistant-mcp
English | 日本語
A voice assistant for Claude Code that reads out a short spoken summary of each reply with VOICEVOX. Like JARVIS or an anime android, it tells you only the conclusion in a calm voice, and drops an occasional acknowledgement or progress report while it works.
Disclaimer: This is an independent, personal project. It is not affiliated with, endorsed by, or officially connected to the VOICEVOX developers, the voice characters' rights holders, or Anthropic.
Features
Status | Feature |
✅ | Reads a 1–3 sentence summary of every reply (no paths, code, URLs or boilerplate) |
✅ | Acknowledges each request ("承知しました" — "Understood") |
✅ | Random fillers and progress reports while working, matched to the tool ("Running the tests") |
✅ | Tells you when it is waiting for you: permission prompts, questions, plan approval |
✅ | Four voice presets (JARVIS-like butler, android, operator, robot) |
✅ | Quiet mode (stops speech and fillers) |
✅ | No overlapping voices across sessions and windows (one player per machine) |
✅ | Plays the first sentence while synthesizing the next |
Speech is in Japanese by default; Claude is told to speak in the user's language.
Related MCP server: VoiceVox MCP Server
How it works
Claude Code ──(stdio)── MCP server ─┐
Claude Code ──(stdio)── MCP server ─┼─ HTTP 127.0.0.1:38121 ─→ hub (first server started) ─→ VOICEVOX
hooks (fillers) ────────────────────┘ │ 127.0.0.1:50021
└─→ speakers (winsound)Claude writes the summary itself. The MCP server's instructions tell Claude to call
speakat the end of every reply with an ear-friendly summary in a JARVIS-like tone.Hub: the first MCP server to start listens on 127.0.0.1; other servers and the hooks send to it. When it exits, the next server that needs to speak takes over.
Fillers: the hook only picks a phrase and posts it to the hub, then exits immediately, so Claude is never slowed down. The hub skips a filler while speaking, in quiet mode, or right after speaking.
speakinterrupts fillers.Waiting alerts: when Claude asks a question (
AskUserQuestion), asks to approve a plan (ExitPlanMode) or shows a permission prompt (Notification), it always says so — queued after current speech, never throttled, silent only in quiet mode.
Requirements
Windows (playback uses
winsound)Python: 3.11 or higher (uv provides it)
VOICEVOX: the engine running at
http://127.0.0.1:50021(start the app)Claude Code (CLI or the VS Code extension)
Installation (user-wide, available in every project)
1. Install the commands
uv tool install git+https://github.com/hirotoitpost/voicevox-assistant-mcpThis puts voicevox-assistant-mcp (MCP server) and voicevox-assistant-hook (fillers) in ~/.local/bin.
2. Register the MCP server for your user
claude mcp add --scope user voice-assistant -- voicevox-assistant-mcpIf you only use the VS Code extension and have no claude command, use the bundled binary:
%USERPROFILE%\.vscode\extensions\anthropic.claude-code-<version>-win32-x64\resources\native-binary\claude.exe
3. Add the hooks and permission
Add to ~/.claude/settings.json (merge into existing permissions / hooks if present):
{
"permissions": {
"allow": ["mcp__voice-assistant"]
},
"hooks": {
"UserPromptSubmit": [
{ "hooks": [{ "type": "command", "command": "voicevox-assistant-hook", "timeout": 3 }] }
],
"PreToolUse": [
{
"matcher": "*",
"hooks": [{ "type": "command", "command": "voicevox-assistant-hook", "timeout": 3 }]
}
],
"Notification": [
{ "hooks": [{ "type": "command", "command": "voicevox-assistant-hook", "timeout": 3 }] }
]
}
}Without the permission entry, Claude Code asks before every spoken summary.
4. Restart
Restart Claude Code (in VS Code: "Developer: Reload Window").
Update / uninstall
On Windows, files in use cannot be replaced: close every Claude Code session and VS Code window first (the MCP server is running), then update from a separate terminal.
uv tool upgrade voicevox-assistant-mcp # update, then restart
uv tool uninstall voicevox-assistant-mcp # also run: claude mcp remove voice-assistant, and remove the hooksUsage
Just talk to Claude.
"静かに" / "be quiet" → stops speech and fillers. "読み上げ再開" / "resume speaking" turns them back on
"アンドロイドの声にして" / "use the android voice" → changes the voice
Voice presets
Preset | Voice |
| VOICEVOX:青山龍星 (しっとり) — calm butler |
| VOICEVOX:ナースロボ_タイプT (ノーマル) |
| VOICEVOX:No.7 (アナウンス) — cool operator |
| VOICEVOX:Voidoll (ノーマル) |
Follow each character's terms of use: credit "VOICEVOX:(character name)" when publishing recorded audio.
MCP tools
Tool | Description |
| Speak a summary (returns immediately) |
| Stop speaking and clear the queue |
| Toggle quiet mode |
| Change the default voice |
| Presets, current state and engine status |
Configuration (environment variables)
Variable | Default | Meaning |
|
| VOICEVOX engine URL |
|
| Default voice |
|
| Hub port (127.0.0.1 only) |
|
|
|
|
| Chance of a filler on each tool call |
|
| Seconds of silence required before a filler |
|
| Chance of acknowledging a request |
|
| Say so when a permission prompt appears |
|
| Say so when Claude has been waiting for input (the summary already says it's done) |
Pass them to the MCP server with claude mcp add ... -e VOICE_ASSISTANT_PRESET=android -- voicevox-assistant-mcp,
and to the hooks with env in settings.json. If you change the port, set the same value in both.
Troubleshooting
Symptom | Check |
No speech at all | Is VOICEVOX running? See |
Summaries but no fillers | Hooks in |
Hub fails to start | Windows reserves some ports at 49152+ for Hyper-V. Check |
Asked for permission every time | Add |
Limitations
It cannot interrupt while Claude is thinking; fillers happen between tool calls
Summary quality depends on Claude
Playback is Windows-only (other OSes stop after synthesizing the wav)
Development
git clone https://github.com/hirotoitpost/voicevox-assistant-mcp.git
cd voicevox-assistant-mcp
uv sync
uv run ruff check .
uv run pytestTo try local code: claude mcp add --scope user voice-assistant -- uv --directory <path> run voicevox-assistant-mcp.
See CONTRIBUTING.md and SECURITY.md.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Video summaries, voice message transcription and translation in the same voice, your own voice TTS
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Let cloud agents talk to you: progress updates spoken on your Mac, and replies you send back.
AI voice generation: text-to-speech and voice cloning from any MCP client.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables Claude Desktop and Claude Code to synthesize and play speech using VOICEVOX text-to-speech engine. Supports multiple voice characters, session-based voice assignment, and queue management for audio playback.772 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides text-to-speech functionality via VoiceVox, enabling Claude to generate spoken audio from text using various voices.2MIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude to speak text with an embedded audio player, supporting 54 voices, voice cloning, and playback controls, all running locally.3-
- AlicenseNot gradedqualityDmaintenanceMulti-engine text-to-speech for AI coding assistants. Speaks responses aloud from Claude Code, Cursor, or VS Code via a Claude Code plugin, MCP server, or CLI pipe.85 PyPIMIT