Famulor CLIFor terminals, scripts and coding agents

Famulor in your terminal.
Every API operation, one command.

Create assistants, start calls, run campaigns and manage leads with one command, in scripts or from your coding agent. Your API key stays in your OS keychain.

Get an API keyRead the docs
npm install -g famulor
  • Every API operation
  • JSON, table, JSONL
  • Key in your OS keychain
Example
$ npm install -g famulor
$ famulor
Famulor CLI
Voice AI agents, straight from your terminal.
$ famulor login
◆  Paste your API key (input hidden):
✓ Logged in
Workspace  Bright Smile Dental
Host  app.famulor.io
Stored in  OS keychain
$ famulor assistants create --name "Front Desk"
✓ Create an assistant · 1153 ms
{
  "data": {
    "id": "3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55",
    "name": "Front Desk",
    "is_active": true,
    "mode": "pipeline",
    "language": "en",
    "created_at": "2026-10-01T09:41:00Z"
  }
}

The Famulor CLI in action

Playing loads YouTube. Privacy

Commands

Every API operation is a command.

Commands are generated from the OpenAPI spec. Type the operation name, or an area plus a verb.

Assistants

assistants
famulor assistants create --name "Front Desk"
famulor update-assistant <id> --llm-temperature 0.4

Calls

calls
famulor create-call --assistant-id <id> --to-number +4930123456
famulor get-call-recording <call-id> --output-file call.ogg

Campaigns and leads

campaigns
famulor add-leads <campaign-id> --phone +4930123456 --name "Mia"
famulor start-campaign <campaign-id>

Phone numbers

phone-numbers
famulor search-available-phone-numbers --country DE
famulor list-phone-numbers --output table

Knowledge bases

knowledge-bases
famulor create-knowledge-base --name "FAQ"
famulor add-knowledge-document <id> --url https://example.com/faq

Anything else

famulor api
famulor commands recording
famulor api GET /assistants --query limit=5

Every area lists its commands: famulor <area>

  • assistants
  • calls
  • campaigns
  • leads
  • phone-numbers
  • voices
  • knowledge-bases
  • tools
  • automations
  • bookings
  • messaging
  • sms
  • history
  • integrations
  • widgets
  • translation
  • loop
  • milian
  • qa
  • dashboards
  • segments
  • callbacks
  • suppression
  • caller-ids
  • sip-trunks
  • carrier-connections
  • white-label
  • workspaces
  • api-keys
  • billing
  • settings
  • account
  • catalog
  • migrations
Output

Readable for you. Parsable for scripts.

One response, three formats. Add --all and the CLI fetches every page of a list.

zsh
famulor list-calls --limit 2 --output table
ID STATUS TO NUMBER DURATION SEC ────────────────────────────────────────────────────────────────────────────── c3a91f-4d2e-4b7a-9c1f-0a1b2c3d4e10 ● completed +1 415 555 0120 142 c3c80e-4d2e-4b7a-9c1f-0a1b2c3d4e11 ● completed +1 415 555 0123 96 2 of 212 · add --all to fetch every page
For coding agents

Your coding agent knows every command.

Agents read every command schema as JSON and get errors back in a form they can parse. Colors, animation and prompts switch off on their own.

Find commands

famulor commands recording

Read the schema

famulor create-call --help --output json

Errors as JSON

{"error":{"code","message","status","exit_code"}}

Works in any agent that runs shell commands

  • Claude Code
  • Codex
  • Cursor
  • Gemini CLI
  • Windsurf
  • Warp
  • OpenClaw
  • Hermes
Agent

You: Call +49 30 123456 with Front Desk.

Bash
famulor commands call
Bash
famulor create-call --help --output json
Bash
famulor create-call --assistant-id 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55 --to-number +4930123456

Agent: Done. The call is started, status: queued.

Safe by default

Nothing happens by accident.

A question before every delete, a preview of every request and a key that never sits in plain text.

Asks before it deletes

Deletes and irreversible actions like buying a number ask first. In scripts you confirm with --yes.

Preview with --dry-run

You see the method, URL, headers and body. The key is redacted and nothing is sent.

No call placed twice

Requests that create something are never retried after a timeout. Rate limits are waited out for you.

Key in the keychain

The key is checked before it is saved, then kept in the macOS, Windows or Linux keychain.

One profile per workspace

Save one login per workspace and switch with famulor auth switch. In CI, FAMULOR_API_KEY is enough.

On your own domain too

White-label partners log in once with --base-url. The profile remembers the host.

zsh
famulor delete-assistant 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55
! Delete an assistant "Front Desk" (3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55) in Bright Smile Dental on app.famulor.io? This cannot be undone. [y/N] n
✗ Cancelled. Nothing was deleted.
famulor create-call --assistant-id 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55 --to-number +4930123456 --dry-run
{ "command": "create-call", "operation_id": "createCall", "method": "POST", "url": "https://app.famulor.io/api/v1/calls", "headers": { "Authorization": "Bearer fam_[REDACTED]", "Content-Type": "application/json" }, "body": { "assistant_id": "3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55", "to_number": "+4930123456" } }
CLI, MCP or API

Three ways in. Pick the one that fits.

All three work on the same workspace and the same data.

This page

Famulor CLI

For terminals, scripts, CI and coding agents.

  • One command per API operation
  • JSON, table or JSONL
  • Key in your OS keychain
Read the docs

MCP Connector

For Claude, ChatGPT and other AI tools in chat.

  • One server URL, OAuth sign-in
  • Famulor tools right in the chat
  • Nothing to install locally
See MCP Connector

REST API

For your own product and backend.

  • OpenAPI specification
  • Real-time webhooks
  • Any language, any framework
See API reference
Everything for developers
At a glance

One tool for the whole platform.

Command per operation

1:1

Generated from the OpenAPI spec.

Output formats

3

JSON, table and JSON Lines.

Clear exit codes

0–5

Success, API, usage, login, not found, cancelled.

Shell completions

3

bash, zsh and fish.

Get started

Ready in three commands.

Install, log in, go.

  1. 01

    Install

    npm install -g famulor. Runs on macOS, Linux and Windows with Node.js 22 or newer.

  2. 02

    Log in

    famulor login asks for your API key from Settings → API & MCP and checks it before saving it.

  3. 03

    Go

    famulor --help shows every area. famulor calls, for example, lists every command for calls.

Works with

More from the platform

Other building blocks teams usually pair with this one.

FAQ

Questions before you go live

What is the Famulor CLI?

The Famulor CLI is the official command-line tool for Famulor. Every public REST API operation is a command: assistants, calls, campaigns, leads, phone numbers, knowledge bases, automations and more. Use it in your terminal, in scripts, in CI or through your coding agent.

What do I need to use the CLI?

Node.js 22 or newer and a workspace plan with API Access. Install it with npm install -g famulor. Create an API key in the dashboard under Settings → API & MCP, then run famulor login.

Where is my API key stored?

famulor login checks the key against the API before anything is saved. It then goes into your system keychain: macOS Keychain, Windows Credential Manager or Linux Secret Service. Without a keychain it is saved to a file only you can read. In CI, set FAMULOR_API_KEY instead.

Can I use the CLI with Claude Code, Codex or Cursor?

Yes. famulor commands <topic> returns matching commands as compact JSON, and famulor <command> --help --output json gives the full schema. Colors, animation and prompts switch off in agents and CI. On failure stdout stays empty and the last stderr line is the error as JSON, with a clear exit code.

When should I use the CLI, MCP Connector or API?

The CLI fits terminals, scripts, CI and coding agents. The MCP Connector brings Famulor into chat tools like Claude or ChatGPT with nothing to install. Use the REST API when you build Famulor into your own product. All three work on the same workspace.

Can I delete something by accident?

Deletes and irreversible actions such as buying numbers, transfers or restores ask for confirmation in a terminal. In scripts, CI and coding agents they only run with --yes. With --dry-run you see the exact request and nothing is sent.

Does it work with several workspaces and white-label?

Yes. An API key belongs to exactly one workspace. Save one profile per workspace with famulor auth login --profile <name> and switch with famulor auth switch. If you run Famulor on your own domain, log in once with --base-url.

Is the CLI stable yet?

The CLI is a public preview (version 0.x). Command names follow the API and may still change before 1.0. A renamed command keeps working for at least one minor version.

Get started

Your workspace, one command away.

Get an API key, install the CLI and start with famulor login.

Get an API keyRead the docs

The Famulor CLI is free and MIT licensed. It needs Node.js 22 or newer and a plan with API Access.