Cartesia — Claude Code MCP server: features and setup
This MCP server for Claude Code connects an agent to Cartesia voice tools. It generates speech, transcribes audio, and manages voices.
no license ★ 18 updated 2026-11-14
claude mcp add --transport http cartesia-mcp https://mcp.cartesia.ai/mcpWhat Cartesia does
The server gives an agent access to Cartesia tools for speech generation, audio transcription, and voice management. It can clone a voice, adapt one to another language, edit pronunciation dictionaries, and retrieve available voices and model details.
For hosted access, sign in to Cartesia; an MCP API key is created for the organization if needed. A local setup requires uv, Python 3.13+ installed through uvx, and a CARTESIA_API_KEY. Checking credit usage requires the separate CARTESIA_ADMIN_API_KEY; a standard key does not work for that operation.
A prompt can also synthesize speech and transcribe the result for verification. The local server saves audio in its working directory by default; set OUTPUT_DIRECTORY to choose another folder.
What it helps with
- turn text into audio with a selected voice
- transcribe an audio file into text
- clone a voice and adapt it to another language
- create a pronunciation dictionary for speech generation
Example prompts for the agent
- Turn this text into audio using a Cartesia voice.
- Transcribe this audio file into text.
- Clone the voice in this file and adapt it to another language.
How to install Cartesia
1Platform CLI: remote server
claude mcp add --transport http cartesia-mcp https://mcp.cartesia.ai/mcp2Platform CLI
claude mcp add --env CARTESIA_API_KEY=<CARTESIA_API_KEY> --env CARTESIA_ADMIN_API_KEY=<CARTESIA_ADMIN_API_KEY> --env OUTPUT_DIRECTORY=<OUTPUT_DIRECTORY> --transport stdio cartesia -- uvx cartesia-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cartesia-mcp <command>
1Platform CLI: remote server
codex mcp add cartesia --url https://mcp.cartesia.ai/mcp2Platform CLI
codex mcp add cartesia --env CARTESIA_API_KEY=<CARTESIA_API_KEY> --env CARTESIA_ADMIN_API_KEY=<CARTESIA_ADMIN_API_KEY> --env OUTPUT_DIRECTORY=<OUTPUT_DIRECTORY> -- uvx cartesia-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cartesia-mcp <command>
Config file
{
"mcpServers": {
"cartesia": {
"url": "https://mcp.cartesia.ai/mcp"
}
}
}{
"mcpServers": {
"cartesia": {
"command": "uvx",
"args": [
"cartesia-mcp"
],
"env": {
"CARTESIA_API_KEY": "<CARTESIA_API_KEY>",
"CARTESIA_ADMIN_API_KEY": "<CARTESIA_ADMIN_API_KEY>",
"OUTPUT_DIRECTORY": "<OUTPUT_DIRECTORY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cartesia-mcp <command>
Config file
{
"servers": {
"cartesia": {
"type": "http",
"url": "https://mcp.cartesia.ai/mcp"
}
}
}{
"servers": {
"cartesia": {
"type": "stdio",
"command": "uvx",
"args": [
"cartesia-mcp"
],
"env": {
"CARTESIA_API_KEY": "<CARTESIA_API_KEY>",
"CARTESIA_ADMIN_API_KEY": "<CARTESIA_ADMIN_API_KEY>",
"OUTPUT_DIRECTORY": "<OUTPUT_DIRECTORY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cartesia-mcp <command>
1Platform CLI: remote server
gemini mcp add -t http cartesia https://mcp.cartesia.ai/mcp2Platform CLI
gemini mcp add -e CARTESIA_API_KEY=<CARTESIA_API_KEY> -e CARTESIA_ADMIN_API_KEY=<CARTESIA_ADMIN_API_KEY> -e OUTPUT_DIRECTORY=<OUTPUT_DIRECTORY> cartesia uvx cartesia-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cartesia-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Cartesia
How do I install Cartesia in Claude Code?
For hosted access, run claude mcp add --transport http cartesia-mcp https://mcp.cartesia.ai/mcp, then select the server in /mcp and sign in to Cartesia.
What does Cartesia do?
The MCP server connects an agent to Cartesia voice APIs. It generates speech, transcribes audio, clones and adapts voices, and manages pronunciation dictionaries.
What does Cartesia require?
Hosted access requires signing in to Cartesia. A local setup needs uv, Python 3.13+, and CARTESIA_API_KEY; credit usage also requires the separate CARTESIA_ADMIN_API_KEY.