Mihu CLI

The Mihu CLI is the official command-line interface for Mihu. Every endpoint of the API is available as a command, so you can build agents, buy numbers, place calls, read conversations and run campaigns without leaving your terminal. In this guide you will:

Install and authenticate the CLI
Run your first commands
Manage several workspaces
Connect your AI IDE to Mihu through MCP

Installation

macOS / Linux
Windows

curl -sSL https://mihu.ai/install.sh | bash

irm https://mihu.ai/install.ps1 | iex

The installer downloads a single binary for your platform, verifies its checksum and puts it on your PATH. No runtime is required. Verify with mihu version. If your shell already has an alias named mihu, the alias wins; rename it or run command mihu.

Quick start

Authenticate

mihu login

The CLI asks for your workspace subdomain (the abc in abc.mihu.ai), opens the API token page of your dashboard, and stores the token you paste. See Authentication for how tokens work.

Look around

mihu whoami          # workspace, balance and where the credentials came from
mihu agents list
mihu numbers list

Place your first call

mihu calls start +14155550123 --agent <agent-uuid> --greeting "Hi, this is a test call from Mihu"

The response includes the call id, the conversation id and a live listen URL.

Key features

Every endpoint, one command tree

Commands mirror the API. Path segments become groups, path parameters become arguments and the HTTP method becomes the verb:

mihu agents webhooks list <agent-uuid>     # GET  /agents/{uuid}/webhooks
mihu campaigns publish <campaign-uuid>     # POST /campaigns/{uuid}/publish
mihu transcriptions transcript <uuid>      # GET  /transcriptions/{uuid}/transcript
mihu commands                              # print all commands

Interactive create and update

Run a create or update command without arguments and the CLI walks you through every field with its description, validates enums and shows the request before sending it:

mihu agents create
# [1/28] name * (string)
#   Required. Internal label for this agent
#   > Support Bot
# [2/28] description (string)
#   > ...

Or pass fields as flags, since every body field is a typed flag:

mihu agents create --name "Support Bot" --language en --tone "Short and friendly"
mihu contacts update <uuid> --email ada@example.com

Scripting and CI

Output is a table on a terminal and JSON when piped, so the CLI composes with jq:

mihu calls list --all -o json | jq '.[] | select(.status == "ended") | .uuid'

In CI, skip mihu login and set two environment variables:

export MIHU_API_TOKEN=your-api-token
export MIHU_TENANT=abc
mihu agents list

Several workspaces

mihu login --name production
mihu login --name staging
mihu -p staging agents list
mihu config use production

MCP for your IDE

Give Claude Code, Cursor, VS Code, Windsurf or Claude Desktop full knowledge of your workspace in one command:

mihu mcp setup cursor

See CLI and MCP.

Any endpoint

For endpoints without a dedicated command, or when you want the raw response:

mihu api /workspace
mihu api /agents/<uuid> -X PATCH -f name="New name"

Common commands

Agents

mihu agents list
mihu agents get <uuid>
mihu agents create --name "Sales" --language en
mihu agents update <uuid> --tone "Formal"
mihu agents from-website https://example.com
mihu agents voice <uuid>
mihu agents webhooks create <uuid> --url https://example.com/hook

Phone numbers

mihu numbers list
mihu numbers search US --type local --area-code 415
mihu numbers buy -f number=+14155550123 -f country_code=US -f type=local
mihu agents channels call provision <agent-uuid> --phone-number-uuid <number-uuid>
mihu numbers release <number-uuid>

Calls

mihu calls start +14155550123 --agent <uuid> --prompt "Confirm tomorrow's appointment"
mihu calls list --status ended
mihu calls get <call-uuid>
mihu calls say <call-uuid> "One moment please"
mihu calls hangup <call-uuid>

Conversations and contacts

mihu conversations list --channel whatsapp --status open
mihu conversations messages <uuid>
mihu conversations reply <uuid> "Thanks, we will call you back"
mihu contacts list --search ada
mihu contacts create --name "Ada" --phone-number +441234567890

Campaigns and tasks

mihu campaigns list
mihu campaigns publish <uuid>
mihu tasks list --status pending
mihu tasks list --type make_call --executor ai

Quality

mihu transcriptions create --voice-file call.mp3 --possible-language en
mihu transcriptions transcript <uuid>
mihu evaluations list
mihu qa-agents list
mihu coaching-agents list

Configuration

Settings live in ~/.config/mihu/config.json, credentials in ~/.config/mihu/credentials.json (mode 0600). On Windows both are under %AppData%\mihu.

mihu config path                       # print the directory
mihu config list                       # saved profiles
mihu config set output json            # default output format
mihu config set disable_update_check true

Environment variables override everything: MIHU_API_TOKEN, MIHU_TENANT, MIHU_BASE_URL, MIHU_PROFILE, MIHU_CONFIG_DIR.

Updates

The CLI checks for a new version once a day and prints a one-line hint. Update with:

mihu update --check
mihu update

Uninstall

mihu uninstall            # removes the binary, keeps your settings
mihu uninstall --purge    # also deletes ~/.config/mihu with saved credentials

Getting Started

Services

Developer Tools

Installation

Quick start

Key features

Every endpoint, one command tree

Interactive create and update

Scripting and CI

Several workspaces

MCP for your IDE

Any endpoint

Common commands

Configuration

Updates

Uninstall

Next steps

CLI and MCP

API Reference

​Installation

​Quick start

​Key features

​Every endpoint, one command tree

​Interactive create and update

​Scripting and CI

​Several workspaces

​MCP for your IDE

​Any endpoint

​Common commands

​Configuration

​Updates

​Uninstall

​Next steps

CLI and MCP

API Reference

Installation

Quick start

Key features

Every endpoint, one command tree

Interactive create and update

Scripting and CI

Several workspaces

MCP for your IDE

Any endpoint

Common commands

Configuration

Updates

Uninstall

Next steps