Voicebox MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Voicebox MCP Server say 'Hello everyone' using Zundamon (speaker 3)"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VoiceBox MCP Server
Model Context Protocol (MCP) server for VOICEVOX text-to-speech integration.
Features
voicebox_speak- Convert text to speechvoicebox_status- Check task statusvoicebox_speakers- List available speakersvoicebox_health- Check system healthvoicebox_metrics- Get system metrics
Prerequisites
VoiceBox TTS API must be running:
cd ~/dev/voicebox-tts ./scripts/start.shVOICEVOX must be running with API server enabled (port 50021)
Installation
cd ~/dev/voicebox-mcp
npm install
npm run buildClaude Code Configuration
Add to ~/.claude/settings.json:
{
"mcpServers": {
"voicebox": {
"command": "node",
"args": ["/Users/shunsukehayashi/dev/voicebox-mcp/dist/index.js"],
"env": {
"VOICEBOX_API_URL": "http://localhost:5001"
}
}
}
}Available Speakers
ID | Name |
0 | 四国めたん (あまあま) |
1 | 四国めたん (ノーマル) |
2 | 四国めたん (セクシー) |
3 | ずんだもん (ノーマル) |
4 | ずんだもん (あまあま) |
5 | ずんだもん (悲嘆) |
6 | 春日部つむぎ (ノーマル) |
7 | 春日部つむぎ (あまあま) |
8 | 春日部つむぎ (ツンデレ) |
Usage in Claude Code
Please use voicebox_speak to say "Hello, world!" with speaker 3 (Zundamon).Check the voicebox system health.List all available VOICEVOX speakers.Development
npm run dev # Watch mode
npm run build # Build
npm start # Run serverAvailable Tools
5 toolsvoicebox_healthB
Check VoiceBox TTS system health
Inputs: no named parameters.
voicebox_metricsC
Get system metrics and statistics
Inputs: no named parameters.
voicebox_speakA
Convert text to speech using VOICEVOX. Non-blocking - queues task and returns immediately with task_id.
Inputs: text (required), speaker.
voicebox_speakersB
List available VOICEVOX speakers
Inputs: no named parameters.
voicebox_statusC
Check the status of a TTS task
Inputs: task_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: health checks system status, metrics provides statistics, speak converts text to speech, speakers lists available voices, and status checks task progress. There is no overlap in functionality, making tool selection straightforward for an agent.
All tools follow a consistent 'voicebox_' prefix with descriptive suffixes (health, metrics, speak, speakers, status). This uniform naming pattern enhances predictability and readability across the toolset.
With 5 tools, the server is well-scoped for a TTS system, covering essential operations like health checks, metrics, speech generation, speaker management, and task monitoring. Each tool serves a clear, necessary function without redundancy.
The toolset covers core TTS workflows effectively, including system monitoring, speech synthesis, and task management. A minor gap exists in lacking tools for advanced operations like canceling tasks or managing speaker configurations, but agents can work around this with the provided tools.
Related MCP Connectors
AI voice generation: text-to-speech and voice cloning from any MCP client.
Remote text-to-speech MCP server with text_to_speech and list_voices tools. Free plan.
Use VoiceCheap’s media tools from your AI agent: transcribe audio, video and YouTube; create, translate and add subtitles to videos; generate YouTube chapters; create speech, design voices or clone voices with permission; generate images and thumbnails; translate and dub videos with optional lip sync; and publish completed projects to your connected channels. Manage project status, transcripts, glossaries and workspace settings through the tools you authorize. Available tools depend on your OAuth permissions and account access. Generation uses existing credits; purchases take place on the VoiceCheap website.
Manage ElevenLabs voice agents and generate speech, music, sound effects, images, and video.