Can I use Aircall as a CLI?

Yes. KosmoKrator exposes a Aircall CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Aircall through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Aircall tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Aircall credentials stored?

Aircall credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Aircall MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

communication

Aircall CLI for AI Agents

Use the Aircall CLI from KosmoKrator to call Aircall tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

8 functions 6 read 2 write Manual OAuth token auth

Submit Aircall feedback View package source

Aircall CLI Setup

Aircall can be configured headlessly with `kosmokrator integrations:configure aircall`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure aircall --set access_token="$AIRCALL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor aircall --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`AIRCALL_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`AIRCALL_URL`	URL `url`	no	API Base URL

Call Aircall Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call aircall.aircall_list_calls '{
  "per_page": 1,
  "page": 1,
  "order": "example_order",
  "from": "example_from",
  "to": "example_to",
  "direction": "example_direction",
  "user_id": 1,
  "number_id": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:aircall aircall_list_calls '{
  "per_page": 1,
  "page": 1,
  "order": "example_order",
  "from": "example_from",
  "to": "example_to",
  "direction": "example_direction",
  "user_id": 1,
  "number_id": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs aircall --json
kosmo integrations:docs aircall.aircall_list_calls --json
kosmo integrations:schema aircall.aircall_list_calls --json
kosmo integrations:search "Aircall" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Aircall.

`aircall.aircall_list_calls`

Read read

List calls from Aircall with optional filters. Supports filtering by date range, direction (inbound/outbound), user ID, phone number, and tags. Returns paginated call records.

Parameters: per_page, page, order, from, to, direction, user_id, number_id, tags

Generic CLI call

kosmo integrations:call aircall.aircall_list_calls '{"per_page":1,"page":1,"order":"example_order","from":"example_from","to":"example_to","direction":"example_direction","user_id":1,"number_id":1}' --json

Provider shortcut

kosmo integrations:aircall aircall_list_calls '{"per_page":1,"page":1,"order":"example_order","from":"example_from","to":"example_to","direction":"example_direction","user_id":1,"number_id":1}' --json

`aircall.aircall_get_call`

Read read

Retrieve detailed information about a specific call in Aircall by its ID. Returns call details including duration, direction, status, recording, and contact information.

Parameters: call_id

Generic CLI call

kosmo integrations:call aircall.aircall_get_call '{"call_id":1}' --json

Provider shortcut

kosmo integrations:aircall aircall_get_call '{"call_id":1}' --json

`aircall.aircall_list_contacts`

Read read

List contacts from Aircall with optional search and pagination. Search by name, phone number, or email. Returns contact details including phone numbers and emails.

Parameters: per_page, page, order, q

Generic CLI call

kosmo integrations:call aircall.aircall_list_contacts '{"per_page":1,"page":1,"order":"example_order","q":"example_q"}' --json

Provider shortcut

kosmo integrations:aircall aircall_list_contacts '{"per_page":1,"page":1,"order":"example_order","q":"example_q"}' --json

`aircall.aircall_create_contact`

Write write

Create a new contact in Aircall. Provide at least a first name or last name, and one phone number or email.

Parameters: first_name, last_name, company_name, information, phone_numbers, emails

Generic CLI call

kosmo integrations:call aircall.aircall_create_contact '{"first_name":"example_first_name","last_name":"example_last_name","company_name":"example_company_name","information":"example_information","phone_numbers":"example_phone_numbers","emails":"example_emails"}' --json

Provider shortcut

kosmo integrations:aircall aircall_create_contact '{"first_name":"example_first_name","last_name":"example_last_name","company_name":"example_company_name","information":"example_information","phone_numbers":"example_phone_numbers","emails":"example_emails"}' --json

`aircall.aircall_update_contact`

Write write

Update an existing contact in Aircall. Provide the contact ID and the fields to update.

Parameters: contact_id, first_name, last_name, company_name, information, phone_numbers, emails

Generic CLI call

kosmo integrations:call aircall.aircall_update_contact '{"contact_id":1,"first_name":"example_first_name","last_name":"example_last_name","company_name":"example_company_name","information":"example_information","phone_numbers":"example_phone_numbers","emails":"example_emails"}' --json

Provider shortcut

kosmo integrations:aircall aircall_update_contact '{"contact_id":1,"first_name":"example_first_name","last_name":"example_last_name","company_name":"example_company_name","information":"example_information","phone_numbers":"example_phone_numbers","emails":"example_emails"}' --json

`aircall.aircall_list_users`

Read read

List all users in the Aircall account. Returns user details including name, email, availability, and assigned phone numbers.

Parameters: none

Generic CLI call

kosmo integrations:call aircall.aircall_list_users '{}' --json

Provider shortcut

kosmo integrations:aircall aircall_list_users '{}' --json

`aircall.aircall_list_numbers`

Read read

List all phone numbers in the Aircall account. Returns number details including the phone number, country, type, and assigned users.

Parameters: none

Generic CLI call

kosmo integrations:call aircall.aircall_list_numbers '{}' --json

Provider shortcut

kosmo integrations:aircall aircall_list_numbers '{}' --json

`aircall.aircall_get_current_user`

Read read

Retrieve the currently authenticated Aircall user. Returns user details including name, email, and availability status.

Parameters: none

Generic CLI call

kosmo integrations:call aircall.aircall_get_current_user '{}' --json

Provider shortcut

kosmo integrations:aircall aircall_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`aircall.aircall_list_calls`

List calls from Aircall with optional filters. Supports filtering by date range, direction (inbound/outbound), user ID, phone number, and tags. Returns paginated call records.

Operation: Read read
Schema command: kosmo integrations:schema aircall.aircall_list_calls --json

Parameter	Type	Required	Description
`per_page`	integer	no	Number of results per page (default: 20, max: 50).
`page`	integer	no	Page number for pagination (default: 1).
`order`	string	no	Sort order: "asc" or "desc" (default: "desc").
`from`	string	no	Start date in ISO 8601 format (e.g., "2026-01-01T00:00:00Z").
`to`	string	no	End date in ISO 8601 format (e.g., "2026-01-31T23:59:59Z").
`direction`	string	no	Filter by call direction: "inbound" or "outbound".
`user_id`	integer	no	Filter by user ID who handled the call.
`number_id`	integer	no	Filter by phone number ID (the Aircall number that received/made the call).
`tags`	array	no	Filter by tags assigned to the call.

`aircall.aircall_get_call`

Retrieve detailed information about a specific call in Aircall by its ID. Returns call details including duration, direction, status, recording, and contact information.

Operation: Read read
Schema command: kosmo integrations:schema aircall.aircall_get_call --json

Parameter	Type	Required	Description
`call_id`	integer	yes	The unique identifier of the call to retrieve.

`aircall.aircall_list_contacts`

List contacts from Aircall with optional search and pagination. Search by name, phone number, or email. Returns contact details including phone numbers and emails.

Operation: Read read
Schema command: kosmo integrations:schema aircall.aircall_list_contacts --json

Parameter	Type	Required	Description
`per_page`	integer	no	Number of results per page (default: 20, max: 50).
`page`	integer	no	Page number for pagination (default: 1).
`order`	string	no	Sort order: "asc" or "desc" (default: "desc").
`q`	string	no	Search query — search contacts by name, phone number, or email.

`aircall.aircall_create_contact`

Create a new contact in Aircall. Provide at least a first name or last name, and one phone number or email.

Operation: Write write
Schema command: kosmo integrations:schema aircall.aircall_create_contact --json

Parameter	Type	Required	Description
`first_name`	string	no	First name of the contact.
`last_name`	string	no	Last name of the contact.
`company_name`	string	no	Company name associated with the contact.
`information`	string	no	Additional notes or information about the contact.
`phone_numbers`	array	no	Array of phone number objects, each with a "label" (e.g., "Work", "Mobile") and "value" (e.g., "+33612345678").
`emails`	array	no	Array of email objects, each with a "label" (e.g., "Work", "Personal") and "value" (e.g., "[email protected]").

`aircall.aircall_update_contact`

Update an existing contact in Aircall. Provide the contact ID and the fields to update.

Operation: Write write
Schema command: kosmo integrations:schema aircall.aircall_update_contact --json

Parameter	Type	Required	Description
`contact_id`	integer	yes	The unique identifier of the contact to update.
`first_name`	string	no	Updated first name of the contact.
`last_name`	string	no	Updated last name of the contact.
`company_name`	string	no	Updated company name associated with the contact.
`information`	string	no	Updated notes or information about the contact.
`phone_numbers`	array	no	Updated array of phone number objects. Each must have "label" and "value". This replaces all existing phone numbers.
`emails`	array	no	Updated array of email objects. Each must have "label" and "value". This replaces all existing emails.

`aircall.aircall_list_users`

List all users in the Aircall account. Returns user details including name, email, availability, and assigned phone numbers.

Operation: Read read
Schema command: kosmo integrations:schema aircall.aircall_list_users --json

Parameter	Type	Required	Description
No parameters.

`aircall.aircall_list_numbers`

List all phone numbers in the Aircall account. Returns number details including the phone number, country, type, and assigned users.

Operation: Read read
Schema command: kosmo integrations:schema aircall.aircall_list_numbers --json

Parameter	Type	Required	Description
No parameters.

`aircall.aircall_get_current_user`

Retrieve the currently authenticated Aircall user. Returns user details including name, email, and availability status.

Operation: Read read
Schema command: kosmo integrations:schema aircall.aircall_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.