claude-voice-notify
Provides integration with ElevenLabs Text-to-Speech services to generate high-quality, realistic voice notifications for task completions and status updates.
Integrates with Google Cloud Text-to-Speech to deliver high-quality neural voice notifications and system alerts for task status changes.
Utilizes OpenAI's Text-to-Speech models to provide natural-sounding voice feedback and clear status notifications during task execution.
Click on "Install 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., "@claude-voice-notifyspeak 'The background task has finished successfully'"
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.
claude-voice-notify
Claude Code 用マルチプロバイダー音声通知 MCP サーバー
Claude Code がタスク完了・確認要求・エラー発生時に音声でユーザーに知らせる MCP サーバーです。 デフォルトは VOICEVOX(ずんだもん) で完全無料・API キー不要。 環境変数 1 行で音声エンジンを差し替えられるプラグイン型設計。
⭐ このツールを使うには Star が必要です。 セットアップ時に GitHub ユーザー名を確認し、Star 済みの方のみ利用できます。
対応プロバイダー(8 種)
値 | 名前 | 料金 | 特徴 |
| VOICEVOX | 無料 | デフォルト・ずんだもん含む100+キャラ |
| COEIROINK | 無料 | つくよみちゃん等 |
| AivisSpeech | 無料 | 高品質ローカル・VOICEVOX 互換 |
| Style-Bert-VITS2 | 無料 | 自分の声・好きなキャラの声を学習可能 |
| Google Cloud TTS | 無料枠あり | 月100万文字無料・Neural2高品質 |
| Fish Audio | 有料 | 高品質クラウド TTS |
| ElevenLabs | 有料(無料枠あり) | 英語最強 |
| OpenAI TTS | 有料 | nova / alloy 等 |
MCP ツール一覧
ツール名 | 用途 | デフォルトメッセージ |
| タスク完了通知 | 「タスクが完了しました」 |
| 確認要求通知 | 「確認をお願いします」 |
| カスタム読み上げ | (text 必須) |
| 接続テスト | 「テスト成功」 |
| プロバイダー一覧表示 | — |
すべてのツールは .voice-config の設定(音量・速度・スピーカー)を自動的に反映します。
方法 A: ワンコマンドセットアップ(推奨)
お好きな場所にクローンしてください。おすすめ:
macOS / Linux:
~/Projects/または~/dev/Windows:
C:\Users\<ユーザー名>\Projects\
macOS / Linux:
# 1. Star する(必須) → https://github.com/kubouchiyuya/claude-voice-notify
# 2. 好きなディレクトリに移動(例: ~/Projects)
cd ~/Projects
# 3. クローン
git clone https://github.com/kubouchiyuya/claude-voice-notify.git
# 4. ディレクトリに入る
cd claude-voice-notify
# 5. セットアップ実行(あとは全自動)
./setup.shWindows:
cd %USERPROFILE%\Projects
git clone https://github.com/kubouchiyuya/claude-voice-notify.git
cd claude-voice-notify
setup.batsetup.sh / setup.bat が自動で行うこと:
ステップ | 内容 |
5-1 | GitHub Star の確認(ユーザー名を聞かれます) |
5-2 | VOICEVOX の検出・インストール案内 |
5-3 |
|
5-4 | プロバイダー選択(対話式で8種から選べる) |
5-5 | キャラクター選択(性別・方言フィルター付き) |
5-6 | VS Code 拡張機能の自動インストール |
5-7 | Claude Code Hooks 設定ガイド表示 |
5-8 | 音声テスト再生 |
セットアップ後にやること:
# 6. VOICEVOX を起動(まだの場合)
# 7. Claude Code Hooks を ~/.claude/settings.json にコピペ(画面の指示に従う)
# 8. テスト
./notify.sh "テスト成功"
# 9. 設定パネルでカスタマイズ(キャラ・速度・音量・エンジン)
./settings.sh
# 10. 完了!Claude Code が音声で通知してくれます方法 B: 手動セットアップ
1. リポジトリを clone してビルド
git clone https://github.com/kubouchiyuya/claude-voice-notify.git
cd claude-voice-notify
npm install
npm run build2. VOICEVOX をインストール(任意)
macOS:
# 公式サイトからダウンロード
open https://voicevox.hiroshiba.jp/Windows:
# winget でインストール
winget install Hiroshiba.VOICEVOX
# または公式サイトからダウンロード
# https://voicevox.hiroshiba.jp/インストールしなくても macOS say / Windows SAPI で動作します。
3. Claude Code Hooks を設定(再起動不要)
~/.claude/settings.json の hooks に追加:
macOS / Linux:
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "/path/to/claude-voice-notify/notify.sh 'タスクが完了しました' complete"
}
]
}
],
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "/path/to/claude-voice-notify/notify.sh '確認をお願いします' confirm"
}
]
}
]
}
}Windows:
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "powershell -ExecutionPolicy Bypass -File C:\\path\\to\\claude-voice-notify\\notify.ps1 'タスクが完了しました' complete"
}
]
}
],
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "powershell -ExecutionPolicy Bypass -File C:\\path\\to\\claude-voice-notify\\notify.ps1 '確認をお願いします' confirm"
}
]
}
]
}
}4. (任意) MCP サーバーも追加
~/.claude.json の mcpServers に追加すると、Claude が状況に応じたカスタムメッセージを読み上げられます:
{
"mcpServers": {
"voice-notify": {
"command": "node",
"args": ["/path/to/claude-voice-notify/dist/index.js"],
"env": {
"NOTIFY_PROVIDER": "voicevox",
"VOICEVOX_SPEAKER": "1"
}
}
}
}5. テスト
# 直接テスト(即実行)
./notify.sh "テスト成功"
# Claude Code 経由(MCP設定後)
# → 「notify_test を実行して」音量・速度調整
# 音量調整(0.0〜1.0、デフォルト: 1.0)
./notify.sh set-volume 0.5 # 半分の音量
./notify.sh set-volume 0.3 # 控えめ(会議中のお隣さん対策)
./notify.sh set-volume 1.0 # 最大音量
# 速度調整(0.5〜2.0、デフォルト: 1.0)
./notify.sh set-speed 1.2 # やや速め
./notify.sh set-speed 0.8 # ゆっくり
# 設定パネル(GUIライクな対話式メニュー)
./settings.shキャラクター管理
# 一覧表示(★ = 現在のデフォルト)
./notify.sh list
# デフォルトキャラを変更
./notify.sh set-speaker 8 # 春日部つむぎ
# 一時的に別キャラで喋らせる(デフォルトは変えない)
./notify.sh "メッセージ" complete 8VOICEVOX キャラクター一覧(主要)
ID | キャラクター | ID | キャラクター |
3 | ずんだもん(ノーマル) | 1 | ずんだもん(あまあま) |
7 | ずんだもん(ツンツン) | 5 | ずんだもん(セクシー) |
22 | ずんだもん(ささやき) | 8 | 春日部つむぎ |
2 | 四国めたん(ノーマル) | 0 | 四国めたん(あまあま) |
10 | 雨晴はう | 9 | 波音リツ |
13 | 青山龍星 | 14 | 冥鳴ひまり |
20 | もち子さん | 46 | 小夜/SAYO |
100+ キャラクターが利用可能。./notify.sh list で全一覧を確認できます。
共通
変数 | 説明 | デフォルト |
| 使用するプロバイダー |
|
VOICEVOX
変数 | 説明 | デフォルト |
| API エンドポイント |
|
| スピーカー ID |
|
COEIROINK
変数 | 説明 | デフォルト |
| API エンドポイント |
|
| スピーカー ID |
|
AivisSpeech
変数 | 説明 | デフォルト |
| API エンドポイント |
|
| スピーカー ID |
|
Style-Bert-VITS2
変数 | 説明 | デフォルト |
| API エンドポイント |
|
| モデル名 |
|
Fish Audio
変数 | 説明 | 必須 |
| API キー | はい |
| ボイス ID | 推奨 |
ElevenLabs
変数 | 説明 | 必須 |
| API キー | はい |
| ボイス ID | — (デフォルト: Rachel) |
OpenAI TTS
変数 | 説明 | 必須 |
| API キー | はい |
| ボイス名 | — (デフォルト: nova) |
Google Cloud TTS
変数 | 説明 | 必須 |
| API キー | はい |
| 音声名 | — (デフォルト: ja-JP-Neural2-B) |
Google Cloud TTS は月100万文字まで無料。./notify.sh set-provider google で切り替え。
Style-Bert-VITS2 をセットアップ
自分の音声データで学習
環境変数を設定:
{
"env": {
"NOTIFY_PROVIDER": "style_bert_vits2",
"STYLE_BERT_VITS2_MODEL": "my-voice"
}
}Udemy や動画制作で使った自分の声をそのまま通知音声にすることもできます。
プロジェクトの CLAUDE.md に以下を追加すると、Claude Code が自動的に音声通知を使うようになります。
templates/CLAUDE.md を参照してください。
クローンした人はワンコマンドで最新版に更新できます:
./update.sh更新内容を確認 → 確認後に
git pull&npm run buildを自動実行リリース通知を受け取るには、リポジトリを Watch > Releases only に設定してください
claude-voice-notify/
├── notify.sh ← 音声通知の本体(bashから直接呼べる)
├── settings.sh ← 設定パネル(キャラ・速度・音量・エンジン)
├── setup.sh ← 初回セットアップ(自動インストール)
├── update.sh ← ワンコマンド更新
├── .voice-config ← 設定ファイル(自動生成・gitignore済み)
├── .voice-enabled ← ON/OFF状態(自動生成)
├── src/ ← MCP サーバー本体(TypeScript)
│ ├── index.ts ← MCPエントリーポイント
│ ├── provider-base.ts ← 音声再生共通処理
│ └── providers/ ← 各プロバイダー実装
├── dist/ ← ビルド済み(npm run build で生成)
├── templates/
│ └── CLAUDE.md ← プロジェクトに組み込むテンプレート
├── vscode-extension/ ← VS Code 拡張機能
└── CLAUDE.md ← Claude Code 用の設定指示設定ファイル(.voice-config)の保存場所:
クローンしたディレクトリ直下に自動生成されます
Git にはコミットされません(
.gitignore済み)手動で編集も可能(key=value 形式)
症状 | 原因 | 対処 |
VOICEVOX に接続できない | アプリが起動していない | VOICEVOX を起動する |
音声が鳴らない(macOS) | afplay の問題 |
|
音声が鳴らない(Windows) | WMP の問題 | PowerShell で手動テスト |
ビルドエラー | node_modules がない |
|
設定が反映されない(MCP) | サーバー未再起動 | VS Code: Cmd+Shift+P → Developer: Reload Window |
免責事項・法的注意事項
音声合成に関する重要事項
本ソフトウェアは音声合成エンジンを利用して音声を生成します。音声合成の利用にあたっては、以下の点にご注意ください。
各音声合成エンジンの利用規約を遵守してください。 本ソフトウェアが対応する各プロバイダー(VOICEVOX、COEIROINK、AivisSpeech、Style-Bert-VITS2、Google Cloud TTS、Fish Audio、ElevenLabs、OpenAI TTS)には、それぞれ独自の利用規約・ライセンスがあります。ユーザーは使用するプロバイダーの規約を確認し、遵守する責任を負います。
キャラクターの音声には著作権・利用条件があります。 VOICEVOX や COEIROINK 等のキャラクター音声は、各キャラクターの権利者が定めるガイドラインに従って使用する必要があります。商用利用・配信・公開等を行う場合は、必ず各キャラクターの利用規約をご確認ください。
音声クローン技術の利用について。 Style-Bert-VITS2、Fish Audio 等の音声クローン技術を使用する場合、他者の声を無断で複製・使用することは、肖像権・パブリシティ権・著作権等の侵害となる可能性があります。音声クローンは必ず本人の同意を得た上で、または自分自身の声のみで使用してください。
生成された音声コンテンツの責任。 本ソフトウェアを使用して生成された音声コンテンツに関する一切の責任は、ユーザーが負うものとします。生成物を公開・配信・商用利用する場合は、適用される法律(著作権法、不正競争防止法、個人情報保護法等)を遵守してください。
免責条項
本ソフトウェアは「現状のまま(AS IS)」で提供されます。作者および貢献者は、本ソフトウェアの使用に起因するいかなる損害(直接的・間接的・偶発的・特別・結果的損害を含む)についても一切の責任を負いません。これには以下が含まれますが、これに限定されません:
音声合成エンジンの利用規約違反に起因する損害
著作権・肖像権・パブリシティ権その他の権利侵害に起因する損害
音声データの不正使用・漏洩に起因する損害
第三者の知的財産権の侵害に起因する損害
本ソフトウェアの不具合・動作不良に起因する損害
ユーザーは、本ソフトウェアの使用が適用される全ての法令に準拠していることを自ら確認する責任を負います。
ライセンス
MIT License - kubouchiyuya
謝辞
VOICEVOX - 無料の音声合成エンジン(ずんだもん等)
COEIROINK - 無料の音声合成ソフトウェア(つくよみちゃん等)
AivisSpeech - 高品質ローカル TTS
Style-Bert-VITS2 - カスタム音声学習
Google Cloud TTS - 高品質クラウド TTS
Fish Audio - リアルタイム音声クローン
ElevenLabs - 感情豊かな音声合成
OpenAI TTS - OpenAI 音声技術
MCP - Model Context Protocol
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/kubouchiyuya/claude-voice-notify'
If you have feedback or need assistance with the MCP directory API, please join our Discord server