Documentation — Uttero

Getting Started

Quick Start

Pick your agent. Voice in under a minute.

STEP 01

Install the plugin

Add the Uttero marketplace and install the voice channel plugin. No npm required.

claude code
# Inside Claude Code
/plugin marketplace add utterodev/uttero-plugins
/plugin install uttero@uttero-plugins

STEP 02

Sign in

Authenticate via Google OAuth. Your credentials are stored at ~/.uttero/credentials.json.

claude code
# Authenticate via Google OAuth
/uttero:configure

STEP 03

Start with voice

Restart Claude Code with the channel flag. The MCP bridge starts automatically, and voice events are pushed into your session in real time.

bash
# Launch with voice channel enabled
claude --dangerously-load-development-channels plugin:uttero@uttero-plugins

Reference

Commands

Plugin commands (Claude Code) and CLI commands (Cursor / Windsurf).

CLAUDE CODE PLUGIN

/uttero:configure

Sign in via Google OAuth. Opens your browser, stores JWT at ~/.uttero/credentials.json.

CLI (CURSOR / WINDSURF)

uttero login

Sign in via Google OAuth. Opens your default browser, exchanges the auth code for a JWT, and stores it locally.

uttero logout

Remove stored credentials from ~/.uttero/credentials.json.

uttero setup

Configure MCP for your agent. Interactive prompts let you choose agent and scope, then writes the config file.

uttero status

Show current authentication status and token expiry time.

uttero bridge

Start the MCP bridge server. Called automatically by your agent — you typically do not run this directly.

Configuration

Supported Agents

Uttero writes the correct MCP config for your agent and scope automatically.

Claude Code

Uses the plugin — no npm required

install /plugin install uttero@uttero-plugins

Cursor

project .cursor/mcp.json global ~/.cursor/mcp.json

Windsurf

project .windsurf/mcp.json global ~/.windsurf/mcp.json

For Cursor and Windsurf, npx uttero setup generates this MCP config:

json
{
  "mcpServers": {
    "uttero": {
      "command": "npx",
      "args": ["-y", "uttero", "bridge"]
    }
  }
}

Architecture

How It Works

From login to live voice call in four steps.

1

Authenticate

uttero login opens your browser for Google OAuth. After consent, a JWT is stored at ~/.uttero/credentials.json.

2

Configure

uttero setup asks you to pick an agent and scope, then writes an MCP config that points to npx uttero bridge.

3

Connect

When your agent starts, it spawns uttero bridge. The bridge reads your JWT and connects to api.uttero.dev via SSE.

4

Call

Your agent calls call_user through MCP. A voice call starts with real-time audio streamed over WebSocket.