leanvox-mcp

Use Leanvox TTS directly from Claude, ChatGPT, Cursor, and any MCP-compatible AI assistant.

Zero code. One config line. Instant text-to-speech in your AI tools.

Quick Setup

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "leanvox": {
      "command": "npx",
      "args": ["-y", "leanvox-mcp"],
      "env": {
        "LEANVOX_API_KEY": "lv_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. Done. ✨

Cursor

Settings → MCP → Add Server:

{
  "leanvox": {
    "command": "npx",
    "args": ["-y", "leanvox-mcp"],
    "env": {
      "LEANVOX_API_KEY": "lv_live_your_key_here"
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "leanvox": {
      "command": "npx",
      "args": ["-y", "leanvox-mcp"],
      "env": {
        "LEANVOX_API_KEY": "lv_live_your_key_here"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add leanvox -- npx -y leanvox-mcp

Set your API key:

export LEANVOX_API_KEY="lv_live_your_key_here"

Related MCP server: LocalVoiceMode

What You Can Do

Once connected, just ask your AI assistant in natural language:

"Read this paragraph aloud using the podcast_conversational_female voice"

"Create a podcast dialogue between two speakers about AI"

"Clone my voice from this audio file"

"What voices are available?"

"Check my Leanvox balance"

The AI assistant handles everything — no code needed.

Available Tools

Resources

Prompts

Authentication

Get your API key at leanvox.com/dashboard.

Pass it via:

1. Environment variable LEANVOX_API_KEY (recommended)

2. Config file ~/.lvox/config.toml

Requirements

• Node.js 18+

• Leanvox API key (get one free)

Standalone Usage

# Run directly
npx leanvox-mcp

# Or install globally
npm install -g leanvox-mcp
leanvox-mcp

Troubleshooting

"Tool not found" — Restart your AI app after adding the config.

"Authentication error" — Check your LEANVOX_API_KEY is set correctly.

"Connection refused" — Make sure Node.js 18+ is installed: node --version

Links

• Leanvox — Main site

• API Docs — Full API reference

• Python SDK — pip install leanvox

• Node.js SDK — npm install leanvox

• GitHub — Source & issues

License

MIT

leanvox-mcp — Text-to-speech for the AI era.