ElevenLabs MCP Server

音声合成と音声処理の強力な API を利用できる、ElevenLabs 公式のModel Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude Desktop、Cursor、Windsurf、OpenAI Agentsなどの MCP クライアントで、音声の生成、音声のクローン作成、音声の文字起こしなどができます。

Claude Desktop ですぐに始める

1. ElevenLabs で API キーを取得します。月 10k クレジットの無料プランがあります。
2. uv（Python パッケージマネージャー）をインストールします。curl -LsSf https://astral.sh/uv/install.sh | sh でインストールするか、その他のインストール方法については uv のリポジトリをご覧ください。
3. Claude > Settings > Developer > Edit Config > claude_desktop_config.json に移動し、以下を追加します。

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

Windows を使用している場合、MCP サーバーを使うには Claude Desktop で「Developer Mode」を有効にする必要があります。左上のハンバーガーメニューから「Help」をクリックし、「Enable Developer Mode」を選択してください。

その他の MCP クライアント

Cursor や Windsurf などのクライアントでは、次の手順を実行します。

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print を実行して設定を取得します。それを、MCP クライアントで指定されている適切な設定ディレクトリに貼り付けます。

これで完了です。MCP クライアントから、以下のツールを通じて ElevenLabs を利用できるようになります。

使用例

⚠️ 警告：これらのツールを使うには ElevenLabs クレジットが必要です。

Claude に次のように尋ねてみましょう。

• 「フィルム・ノワールの探偵のように話し、古典映画について質問に答えられる AI エージェントを作成して」
• 「賢く年老いたドラゴンのキャラクターの音声を 3 種類生成して。気に入った音声を選んで、自分の音声ライブラリに追加します」
• 「この自分の声の録音を、中世の騎士のような声に変換して」
• 「密林で雷雨が起き、動物たちが天候に反応するサウンドスケープを作成して」
• 「この音声をテキストに変換して、話者を識別してから、人物ごとに固有の声を使って音声に戻して」

オプション機能

ELEVENLABS_MCP_BASE_PATH 環境変数を claude_desktop_config.json に追加すると、相対パスで指定したファイルを MCP サーバーが検索・出力するベースパスを指定できます。

コントリビューション

コントリビューションする場合、またはソースから実行する場合は、次の手順に従います。

1. リポジトリをクローンします。

git clone https://github.com/elevenlabs/elevenlabs-mcp
cd elevenlabs-mcp

2. uv を使って仮想環境を作成し、依存関係をインストールします。

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

3. .env.example を .env にコピーし、ElevenLabs API キーを追加します。

cp .env.example .env
# Edit .env and add your API key

4. すべて正常に動作することを確認するため、テストを実行します。

./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

5. Claude Desktop にサーバーをインストールします：mcp install elevenlabs_mcp/server.py

6. MCP Inspector でローカルにデバッグとテストを行います：mcp dev elevenlabs_mcp/server.py

トラブルシューティング

Claude Desktop で実行した際のログは、次の場所にあります。

• Windows：%APPDATA%\Claude\logs\mcp-server-elevenlabs.log
• macOS：~/Library/Logs/Claude/mcp-server-elevenlabs.log

特定のツールを使用した際のタイムアウト

音声のデザインや音声の分離など、一部の ElevenLabs API 操作は完了までに時間がかかる場合があります。開発モードで MCP inspector を使用すると、ツールが目的のタスクを完了していてもタイムアウトエラーが発生することがあります。

Claude などのクライアントを使用する場合、この問題は発生しないはずです。

MCP ElevenLabs：spawn uvx ENOENT

「MCP ElevenLabs: spawn uvx ENOENT」というエラーが発生した場合は、ターミナルで次のコマンドを実行して、絶対パスを確認してください。

which uvx

絶対パス（例：/usr/local/bin/uvx）を確認したら、そのパスを使うように設定を更新します（例："command": "/usr/local/bin/uvx"）。これにより、正しい実行ファイルが参照されます。