Interweave

Voice I/O MCP server for Claude Code. Speak and listen through your mic and speakers.

Uses Kokoro MLX (TTS), Parakeet MLX (STT), and Silero VAD. Runs locally on Apple Silicon.

Install

curl -fsSL https://raw.githubusercontent.com/EndlessHoper/interweave/main/install.sh | bash

This will:

1. Install Python dependencies (~4.5GB total, includes torch and ML models)
2. Download ML models (Kokoro TTS, Parakeet STT, Silero VAD)
3. Register interweave with Claude Code

After install, start a new Claude Code session and talk.

Manual install

If you prefer to install step by step:

uv tool install --python ">=3.11" interweave
claude mcp add interweave -- interweave

Codex

uv tool install --python ">=3.11" interweave
codex mcp add interweave -- interweave

OpenCode

uv tool install --python ">=3.11" interweave

Then add to opencode.json:

{
  "mcp": {
    "interweave": {
      "type": "local",
      "command": ["interweave"],
      "enabled": true
    }
  }
}

Update

uv tool upgrade interweave

Uninstall

uv tool uninstall interweave
claude mcp remove interweave

# Optional: remove cached ML models (~2GB)
rm -rf ~/.cache/huggingface/hub/models--mlx-community--Kokoro-82M-bf16
rm -rf ~/.cache/huggingface/hub/models--animaslabs--parakeet-tdt-0.6b-v3-mlx
rm -rf ~/.cache/torch/hub/snakers4_silero-vad_master

Requirements

• macOS with Apple Silicon
• Python 3.11+
• Microphone and speakers
• uv (curl -LsSf https://astral.sh/uv/install.sh | sh)