KosmoKrator

communication

Aircall MCP Integration for Codex

Connect Aircall to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

8 functions 6 read 2 write Manual OAuth token auth
Submit Aircall feedback View package source

Connect Aircall to Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Aircall MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "mcpServers": {
    "kosmokrator-aircall": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=aircall",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=aircall --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Aircall instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Aircall Tools Visible to Codex

Codex sees stable MCP tool names generated from the Aircall integration catalog.

MCP toolSource functionTypeDescription
integration__aircall__aircall_list_calls aircall.aircall_list_calls 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.
integration__aircall__aircall_get_call aircall.aircall_get_call Read Retrieve detailed information about a specific call in Aircall by its ID. Returns call details including duration, direction, status, recording, and contact information.
integration__aircall__aircall_list_contacts aircall.aircall_list_contacts 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.
integration__aircall__aircall_create_contact aircall.aircall_create_contact Write Create a new contact in Aircall. Provide at least a first name or last name, and one phone number or email.
integration__aircall__aircall_update_contact aircall.aircall_update_contact Write Update an existing contact in Aircall. Provide the contact ID and the fields to update.
integration__aircall__aircall_list_users aircall.aircall_list_users Read List all users in the Aircall account. Returns user details including name, email, availability, and assigned phone numbers.
integration__aircall__aircall_list_numbers aircall.aircall_list_numbers Read List all phone numbers in the Aircall account. Returns number details including the phone number, country, type, and assigned users.
integration__aircall__aircall_get_current_user aircall.aircall_get_current_user Read Retrieve the currently authenticated Aircall user. Returns user details including name, email, and availability status.

Related Aircall Pages

Aircall CLIUse direct JSON commands instead of MCP discovery. Aircall MCPFull gateway reference and MCP tool names. KosmoKrator for CodexClient-level gateway setup.