HanoLab Voice Conversion

io.github.obrr-hhxPublished by GitHub account obrr-hhxv1.0.2Updated Oct 24, 2026

Convert uploaded speech or singing with your saved HanoLab voices, using OAuth and credit quotes.

VerifiedStreamable HTTPWeb executableMedia & DesignAI & ML

Overview

AI-generated overview

HanoLab's remote MCP server lets an assistant convert uploaded speech or singing with your saved voices, using OAuth sign-in and credit quotes.

What you can do
  • Check the connected account, its plan and available credits
  • List saved voices and recent uploads, and create a private one-hour browser upload link
  • Prepare a fixed credit quote for a chosen audio file and owned voice
  • Submit the conversion after budget confirmation, then poll task status and return completed audio links
  • Review recent conversions submitted through the connection
When to use it
Useful when you want an assistant to run HanoLab voice conversion on recorded speech or singing with voices already saved in your account, with an explicit quote and budget check before any credits are spent. It does not clone new voices or handle purchases or subscription changes.
Requirements
A remote Streamable HTTP endpoint added in a client that supports remote MCP and OAuth, plus a HanoLab sign-in and consent flow. An existing Starter, Creator or Pro account is required. Uploads go through a private browser link; the tools cannot read local paths or chat attachments directly.
Before you install
Converting spends HanoLab credits; confirm the quoted cost and your maximum budget before submitting, and reuse the same quote after an interruption to avoid a second debit. Uploads are limited to 15 minutes and 100 MB, and MP4 input returns audio rather than a re-scored video. Only use voices and audio you own or have permission to use, and note that results are shared with the connected AI host.

Installation

In SourceWeft

  1. Open HanoLab Voice Conversion in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.obrr-hhx%2Fhanolab/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hanolab-voice-conversion": {
      "type": "http",
      "url": "https://hanolab.com/mcp"
    }
  }
}

README

HanoLab integrations

Voice conversion for recorded speech and singing, with private saved voices, credit quotes, and resumable results.

HanoLab · Remote MCP guide · CLI guide · Privacy · Support

This repository distributes public connection metadata, two agent skills, and the client source from the public CLI release. The hosted service implementation is maintained separately.

Remote MCP

Add https://hanolab.com/mcp as a Streamable HTTP MCP server in a client that supports remote MCP and OAuth. Complete the HanoLab sign-in and consent flow. Reading a skill or copying a configuration does not connect your account or install tools.

The remote MCP currently converts uploaded recordings using voices already saved in your account. It can inspect credits and voices, create a private upload link, quote a conversion, submit an approved conversion, and recover its status or output. It does not clone a new voice or expose purchases or subscription changes.

The JSON shape varies by client. mcp.json is an HTTP-style example; use the host's own remote-server setup instructions when necessary.

Example requests after connecting:

  • "Show my saved voices and credits. Do not start a conversion."
  • "Give me a private upload link for my recording, then quote conversion using my saved voice. Wait for my budget confirmation."
  • "Recover the conversion we already submitted and return its result. Do not start a new paid task."

Agent skills

Install both public skills using the Skills CLI:

sh
npx skills add hanolab-ai/hanolab-integrations

Or select one:

sh
npx skills add hanolab-ai/hanolab-integrations --skill hanolab-mcpnpx skills add hanolab-ai/hanolab-integrations --skill hanolab
  • hanolab-mcp: the connected remote MCP workflow, private browser uploads, exact quotes, confirmed credit budgets, and resuming existing tasks.
  • hanolab: local terminal workflow for music generation, voice cloning/conversion, stem separation, mastering, and resumable downloads. Requires a separately installed CLI and local file access.

Local CLI

Requires Node.js 20+ and a HanoLab API key. Install the current release and authenticate privately:

sh
npm install -g https://hanolab.com/downloads/hanolab-cli-0.2.2.tgzhanolab auth loginhanolab help

The CLI client source is copied from the public 0.2.2 release. Release checksums identify the exact downloadable artifact. The client sends authenticated API requests to HanoLab and streams audio uploads/downloads; inspect the source and the privacy policy before connecting your account.

Create the key on the account page and enter it at the hidden terminal prompt. Do not paste credentials into a chat or a project file.

Account access and cost

MCP and API access currently use an existing Starter, Creator, or Pro account. Audio processing consumes the account's credits; checking credits, saved voices, and a quote does not execute a conversion. Follow the server's measured quote and the user's explicitly authorized maximum budget. A successful connection does not purchase a plan or supply unlimited processing.

Uploads through remote MCP support audio or MP4 soundtracks up to 15 minutes and 100 MB; MP4 conversion returns audio rather than a replaced video soundtrack. Only use voices and audio you own or have permission to use. Results are shared with the connected AI host as described in the privacy policy.

Registry metadata

server.json describes the hosted remote endpoint for the official MCP Registry. A source repository or configuration file by itself does not indicate registry approval, third-party listing, or compatibility with every AI host.

Updating

Keep these public skills aligned with HanoLab's documented tools and current CLI release. Publish a new registry metadata version when its public fields change. Do not add secrets, review-account credentials, signed private audio links, or hosted backend source to this repository.

Source: README.md at commit 5282218

Tools

9

get_profile

Connected account

Identify the HanoLab account connected to these tools.

Takes no parameters.

get_credits

Credit balance

Read the connected account’s plan and available credits. Does not purchase credits.

Takes no parameters.

list_voices

Saved voices

List the connected user’s own saved voices and whether they are ready. If none are ready, open voicelab to create one.

Takes no parameters.

list_audio

Uploaded audio

List recent audio uploaded through this connection. Use the exact audio_id, never a local path or an arbitrary URL.

Takes no parameters.

prepare_voice_conversion

Estimate voice conversion

Prepare a fixed quote for uploaded audio and a ready owned voice. No credits are spent. Explain estimated_credits, obtain the user’s budget and explicit confirmation, then use convert_voice with this exact quote_id.

Parametersaudio_idrequiredvoice_idrequiredfull_song

convert_voice

Convert voice

Spend HanoLab credits to submit the prepared conversion ONLY after the user confirms its cost and budget. Reuse the exact quote_id after interruption: repeated calls return the original task without another debit. A failed task needs a separate user decision before a new quote.

Parametersquote_idrequiredconfirmedrequiredmax_creditsrequired

get_task

Conversion status and results

Check an owned task and return completed audio links. Refreshes worker status and may persist completion or a failure refund. Poll about every 10 seconds; do not submit a new paid task while waiting.

Parameterstask_idrequired

list_conversions

Recent conversions

Find recent conversions submitted with this connection. Use get_task to refresh a task. This does not start new tasks.

Takes no parameters.

Version history

2
  1. v1.0.2LatestOct 14, 2026
  2. v1.0.0Oct 14, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.