@larvoice/mcp

MCP server for Larvoice Text-to-Speech API. Use this package to connect Larvoice with Cursor, Codex, Claude Desktop, Kiro, Antigravity, OpenClaw, Hermes, or any MCP client that can run a local command.

Package:

npx -y @larvoice/mcp

Auth

Easy login:

npx -y @larvoice/mcp login

This opens a local browser page where you can paste your Larvoice API key. The key is verified and saved locally at ~/.larvoice/mcp.json.

You can also put your Larvoice API key in the MCP server environment:

LARVOICE_API_KEY=lv_your_key

Your MCP client passes this value to @larvoice/mcp when it starts the server.

Supported Clients

| Client | Config shape | | --- | --- | | Cursor | JSON mcpServers | | Codex | TOML mcp_servers | | Claude Desktop | JSON mcpServers | | Kiro | MCP command server | | Antigravity | MCP command server | | OpenClaw | MCP command server | | Hermes | MCP command server |

Installless Usage

Use with any MCP client that supports command-based MCP servers:

{
  "mcpServers": {
    "larvoice": {
      "command": "npx",
      "args": ["-y", "@larvoice/mcp"],
      "env": {
        "LARVOICE_API_KEY": "lv_your_key",
        "LARVOICE_BASE_URL": "https://api.larvoice.com"
      }
    }
  }
}

LARVOICE_BASE_URL is optional. Default: https://api.larvoice.com.

Codex Config

[mcp_servers.larvoice]
command = "npx"
args = ["-y", "@larvoice/mcp"]

[mcp_servers.larvoice.env]
LARVOICE_API_KEY = "lv_your_key"
LARVOICE_BASE_URL = "https://api.larvoice.com"

Cursor Config

{
  "mcpServers": {
    "larvoice": {
      "command": "npx",
      "args": ["-y", "@larvoice/mcp"],
      "env": {
        "LARVOICE_API_KEY": "lv_your_key",
        "LARVOICE_BASE_URL": "https://api.larvoice.com"
      }
    }
  }
}

Claude Desktop Config

{
  "mcpServers": {
    "larvoice": {
      "command": "npx",
      "args": ["-y", "@larvoice/mcp"],
      "env": {
        "LARVOICE_API_KEY": "lv_your_key",
        "LARVOICE_BASE_URL": "https://api.larvoice.com"
      }
    }
  }
}

Other MCP Clients

Use this command and environment:

command: npx
args: -y @larvoice/mcp
env:
  LARVOICE_API_KEY=lv_your_key
  LARVOICE_BASE_URL=https://api.larvoice.com

Smoke Test

LARVOICE_API_KEY=lv_your_key npx -y @larvoice/mcp

When connected through an MCP client, call larvoice_get_account first to verify the API key.

Tools

• larvoice_get_account
• larvoice_get_usage
• larvoice_list_languages
• larvoice_upload_voice
• larvoice_list_voices
• larvoice_get_voice
• larvoice_update_voice
• larvoice_delete_voice
• larvoice_preview_tts
• larvoice_preview_voice
• larvoice_create_tts_job
• larvoice_create_tts_batch
• larvoice_get_job
• larvoice_list_jobs
• larvoice_cancel_job

Notes

• Get a Larvoice API key from https://t.me/larvoice_api_bot.
• Store LARVOICE_API_KEY in MCP env config.
• Upload voice files as mp3, wav, or m4a.
• Use voice_id after uploading a voice.
• Use preview tools before long jobs.
• Use batch for multiple clips.
• Poll jobs until completed or failed.