Aircall

Aircall

This connector works with one Aircall company through the Aircall Public API (https://api.aircall.io/v1, users on /v2), signed in with an API ID and API token (HTTP Basic auth). It reads users, teams, numbers, calls with their recordings, voicemails and AI insights, and contacts, and it can add notes and tags to calls, create and update contacts and start calls from an agent's Aircall Workspace.

Setup (about 3 minutes, Aircall admin needed)

1. Sign in to the Aircall Dashboard at https://dashboard.aircall.io as an admin.
2. Open Integrations & API, then API Keys, and click Generate an API key (older dashboards: Company settings, API Keys), give it a name.
3. Copy the API ID into AIRCALL_API_ID and the API token into AIRCALL_API_TOKEN. Aircall shows the token only once.
4. Install and run aircall_ping, then aircall_get_company.

The key acts for the whole company: share this MCP server only with people allowed to see all calls and contacts.

Personal data. Calls, phone numbers, contacts, recordings, voicemails, transcripts and AI summaries are personal data of callers and agents. Read only what the user asks for, do not copy recordings or transcripts elsewhere without a reason, and remember that recording and voicemail links are playable by anyone who has them (direct links for 1 hour, short links for 3 hours).

Writes: confirm first. aircall_comment_call, aircall_tag_call, aircall_archive_call, aircall_create_contact, aircall_update_contact, aircall_dial_number change data agents see; show the user what will change and wait for a yes. aircall_start_outbound_call rings a real person right away and outbound minutes may cost money: confirm caller, number and line first. aircall_delete_contact is installed switched off.

How to work

1. People and lines: aircall_list_users, aircall_get_user, aircall_list_user_numbers, aircall_get_user_availability, aircall_list_user_availabilities, aircall_list_teams, aircall_get_team, aircall_list_numbers, aircall_get_number.
2. Calls: aircall_list_calls for a time range, aircall_search_calls to filter by direction, user, phone number or tags, aircall_get_call for one call. Times are UNIX timestamps in seconds; pass order=desc for the newest first. Only the last six months are available and at most 10,000 calls per query, so narrow with from and to.
3. AI insights for ended calls (Aircall AI add-on, AI Assist or AI Assist Pro): aircall_get_call_transcription, aircall_get_call_summary, aircall_get_call_sentiments, aircall_get_call_topics, aircall_get_call_action_items. Without the add-on they answer 403 or 404.
4. Follow-up on a call: aircall_comment_call (at most five notes per call, they cannot be edited), aircall_tag_call with ids from aircall_list_tags, aircall_archive_call.
5. Contacts (shared contacts only, not CRM-synced ones): aircall_list_contacts, aircall_search_contacts, aircall_get_contact, aircall_create_contact, aircall_update_contact.
6. Calling: aircall_start_outbound_call places the call from the agent's desktop Workspace (the agent must be online and available); aircall_dial_number only fills in the dialer.
7. Webhooks: aircall_list_webhooks (read-only, tokens removed).

Paging: lists answer with meta (total, current_page, per_page, next_page_link). Pass page=2, 3, and so on until next_page_link is null. per_page is 1 to 50.

Rate limit: Aircall allows 120 requests per minute for the whole company, shared by every integration using its keys. A 429 means wait until the minute is over; avoid paging through thousands of calls.

Common errors

• 403 Forbidden on every tool: the API ID or token is wrong or the key was deleted.
• 404 on a call id: the call does not exist or is older than six months; on an AI endpoint: no transcript or insight for that call.
• 405 on starting or dialing a call: the user is not available, is on a call or is not assigned to the number.
• 400 on a note: the call already has five notes.

Out of scope here: SMS and WhatsApp messages, transferring live calls, pausing or deleting recordings, outbound campaigns, managing users, teams, numbers, tags and webhooks.