VoiceCard

Clone your voice and turn it into a shareable waveform video, all driven by MCP. No GUI. Apple Silicon only.

Voice cloning is now commodity. The differentiator is delivery: a short MP4 with a beautiful audio-reactive waveform plays inline in WhatsApp, iMessage, Signal, and Slack, where raw audio files stall, fail to autoplay, or won't cross iOS/Android. Every clip you send is also an ad for the tool. That is the whole idea.

The front end is the MCP. You talk to it from Claude Code, Cursor, or any MCP-aware agent:

"Clone my voice from ~/Desktop/me.mov (here's the transcript), then make a 15-second Miami-palette clip saying happy birthday, with my photo in the center."

How it works

Fully standalone. Speech is generated locally by mlx-audio (Qwen3-TTS via MLX), the waveform video is rendered with MLX / Pillow, and muxed with ffmpeg. No cloud, no Voicebox, no desktop app.

Cloning is zero-shot in-context learning: it trims your reference to ~12 seconds and conditions on it. There is no training step and no separate model per voice.

Requirements

• Apple Silicon Mac (arm64). Enforced at startup.

• ffmpeg on PATH (brew install ffmpeg).

• First run downloads the Qwen3-TTS weights (~a few GB) into the Hugging Face cache.

Install

uv tool install ./voicecard-mcp        # or: uv run voicecard

Register with Claude Code (stdio):

claude mcp add -s user voicecard -- uv --directory /path/to/voicecard-mcp run voicecard

Tools

Palettes: Noir (default), 70s Gold, Miami, Aurora, Sunset, Mint, Blueprint Aspect: square (1080², default), portrait (9:16) Layout: linear (default — circular photo + compact gradient waveform below, Dynamic-Island style) · circle (centered audio-reactive spectrum ring) Arc (circle layout only): full (default, mirrored ring) · top (spikes over the top half)

Config (env)

Notes

• Output is stereo, +faststart, H.264 High profile — tuned to autoplay inline in messengers.

• The waveform is stylized to always look alive, not a diagnostic spectrum analyzer.

• Core ML / ANE offload of the autoregressive decoder is not planned (dynamic shapes + KV cache + sequential decode are a poor ANE fit). A future Core ML vocoder offload is the only piece worth exploring.

License

MIT. You are responsible for only cloning voices you own or are authorized to use.