Skip to main content
Glama
Aircall MCP Server

Aircall MCP Server

Aircall MCP Server

License: MIT MCP TypeScript

MCP server for the Aircall Public API — 83 tools for calls, transcriptions, AI insights, contacts, SMS, users, teams, and more. Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible AI assistant. Maintained by Cassia Research.

Every tool is verified against the official Aircall API reference. Tools carry MCP annotations (readOnlyHint, destructiveHint, titles), so clients like Claude Desktop can group read-only tools and gate destructive ones.

Not an official Aircall product. This is a community server built and maintained by Cassia Research.

Installation

This is our default integration path. No Node.js or config-file editing required for end users — Claude Desktop runs the server on its own bundled runtime.

Build the extension:

npm install
npm run bundle   # builds TypeScript and packs aircall-mcp.mcpb

Install it:

  1. Share aircall-mcp.mcpb with your team (Slack, Drive, or this repo's Releases).

  2. Double-click it (or Claude Desktop → Settings → Extensions → Advanced settings → Install extension…).

  3. Enter your Aircall API ID and API Token — created in the Aircall Dashboard under Integrations & API → API Keys. The token is stored in your OS keychain.

  4. Optionally enable Read-only mode to expose only the 36 read tools.

To ship an update: bump the version (see CLAUDE.md), run npm run bundle again, and have users double-click the new file — it updates in place, keeping their saved credentials.

Claude Desktop / Cursor — manual config

{
  "mcpServers": {
    "aircall": {
      "command": "npx",
      "args": ["-y", "@cassiaresearch/aircall-mcp-server"],
      "env": {
        "AIRCALL_API_ID": "your_api_id",
        "AIRCALL_API_TOKEN": "your_api_token"
      }
    }
  }
}

CLI

npx @cassiaresearch/aircall-mcp-server --api-id=xxx --api-token=yyy

# Read-only mode
npx @cassiaresearch/aircall-mcp-server --api-id=xxx --api-token=yyy --read-only

# Only specific categories
npx @cassiaresearch/aircall-mcp-server --api-id=xxx --api-token=yyy --tools=calls,contacts

Related MCP server: boondmanager-mcp-server

Tools (83)

Category

Tools

Highlights

Calls

24

list/search calls, transcription, AI summary, sentiments, topics, action items, predicted CSAT, custom summary, playbook results, evaluations, comments, tags, archive/unarchive, transfer, recording controls, insight cards, AI Voice Agent outbound calls

Contacts

12

CRUD plus phone number and email management

Users

10

CRUD, availability, start call, dial, user numbers (API v2)

Teams

6

CRUD and membership

Numbers

5

list/get/update, music & messages, A2P registration status

Tags

5

CRUD

Webhooks

5

CRUD

Messages

5

send SMS/MMS, agent-conversation send, number messaging configuration

Dialer

6

per-user power dialer campaigns

Company

5

ping (connectivity test), company info, integration enable/disable

Full per-tool documentation with parameters: docs/tools/README.md (generated from the server itself via npm run docs).

Configuration

Option

Env var

Description

--api-id

AIRCALL_API_ID

Aircall API ID (required)

--api-token

AIRCALL_API_TOKEN

Aircall API token (required)

--read-only

AIRCALL_READ_ONLY=true

Expose only read tools (36)

--tools=...

AIRCALL_TOOLS

Comma-separated tools or categories; all (default) or read

Notes:

  • Authentication is HTTP Basic with the org-level api_id:api_token pair.

  • Requests are rate-limited client-side to respect Aircall's 60 req/min limit.

  • Conversation Intelligence tools (transcription, summary, sentiments, topics, action items, CSAT, playbooks, evaluations) require the corresponding Aircall AI add-ons on your account — without them the API returns 403/404.

Development

npm install
npm run build        # compile TypeScript to dist/
npm run lint         # eslint
npm run docs         # regenerate docs/tools/README.md from the built server
npm run bundle       # build + pack aircall-mcp.mcpb (Claude Desktop extension)

License

MIT — see LICENSE.

Available Tools

83 tools
aircall_add_campaign_numbersA

Add phone numbers to a user's power dialer campaign.

Inputs: user_id (required), phone_numbers (required).

aircall_add_commentA

Add a comment to a call. Comments are visible in the Aircall dashboard.

Inputs: call_id (required), content (required).

aircall_add_emailA

Add an email address to an existing contact.

Inputs: label (required), value (required), contact_id (required).

aircall_add_phoneA

Add a phone number to an existing contact.

Inputs: label (required), value (required), contact_id (required).

aircall_add_tagsB

Add tags to a call. Tags help categorize and filter calls.

Inputs: tags (required), call_id (required).

aircall_add_user_to_teamA

Add a user to a team. Users can belong to multiple teams.

Inputs: team_id (required), user_id (required).

aircall_archive_callA

Archive a call. Archived calls are hidden from the main call list.

Inputs: call_id (required).

aircall_check_availabilityA
Read-only

Check if a specific user is currently available to take calls.

Inputs: user_id (required).

aircall_create_campaignA

Create an active power dialer campaign for a user with a list of phone numbers to dial. A user can have only one active campaign.

Inputs: user_id (required), phone_numbers (required).

aircall_create_configA

Create the messaging configuration for an Aircall number, optionally setting a callback URL for incoming message events.

Inputs: number_id (required), callback_url.

aircall_create_contactA

Create a new contact with optional phone numbers and emails.

Inputs: emails, last_name, first_name, information, +2 more.

aircall_create_tagA

Create a new tag for categorizing calls.

Inputs: name (required), color, description.

aircall_create_teamA

Create a new team. Teams group users together for call routing and organization.

Inputs: name (required).

aircall_create_userA

Create a new user in Aircall. An invitation email will be sent.

Inputs: email (required), last_name (required), first_name (required), role_id, +1 more.

aircall_create_webhookB

Create a new webhook to receive real-time event notifications at a URL.

Inputs: url (required), events (required).

aircall_delete_campaignA
Destructive

Delete a user's power dialer campaign.

Inputs: user_id (required).

aircall_delete_configA
Destructive

Delete the messaging configuration for an Aircall number.

Inputs: number_id (required).

aircall_delete_contactA
Destructive

Delete a contact. This action cannot be undone.

Inputs: contact_id (required).

aircall_delete_emailA
Destructive

Delete an email address from a contact.

Inputs: email_id (required), contact_id (required).

aircall_delete_phoneA
Destructive

Delete a phone number from a contact.

Inputs: phone_id (required), contact_id (required).

aircall_delete_recordingA
Destructive

Permanently delete the recording of a call. This cannot be undone.

Inputs: call_id (required).

aircall_delete_tagA
Destructive

Delete a tag. Existing calls with this tag will lose it.

Inputs: tag_id (required).

aircall_delete_teamA
Destructive

Delete a team. Users in the team will not be deleted.

Inputs: team_id (required).

aircall_delete_userA
Destructive

Delete a user from Aircall. This action cannot be undone.

Inputs: user_id (required).

aircall_delete_voicemailA
Destructive

Permanently delete the voicemail of a call. This cannot be undone.

Inputs: call_id (required).

aircall_delete_webhookA
Destructive

Delete a webhook. The URL will no longer receive event notifications.

Inputs: webhook_id (required).

aircall_dialA

Open the Aircall phone app with a number pre-dialed. The user can then initiate the call manually.

Inputs: to (required), user_id (required).

aircall_disable_integrationA

Disable the integration associated with the current API credentials.

Inputs: no named parameters.

aircall_enable_integrationA

Enable the integration associated with the current API credentials.

Inputs: no named parameters.

aircall_get_action_itemsA
Read-only

Get AI-detected action items from a call.

Inputs: call_id (required).

aircall_get_callA
Read-only

Get detailed information about a specific call including comments, tags, participants, and recording URLs.

Inputs: call_id (required).

aircall_get_campaignA
Read-only

Get a user's active power dialer campaign. Each user has at most one active campaign.

Inputs: user_id (required).

aircall_get_campaign_numbersA
Read-only

Get the phone numbers in a user's power dialer campaign.

Inputs: user_id (required), page, per_page.

aircall_get_companyA
Read-only

Get information about the Aircall company account including user and number counts.

Inputs: no named parameters.

aircall_get_configA
Read-only

Get the messaging configuration for an Aircall number.

Inputs: number_id (required).

aircall_get_contactA
Read-only

Get detailed information about a specific contact.

Inputs: contact_id (required).

aircall_get_custom_summaryA
Read-only

Get the custom summary result for a call (requires AI Assist Pro). Returns results for each custom summary template section.

Inputs: call_id (required).

aircall_get_evaluationsA
Read-only

Get call quality evaluations (scorecards, feedback, scores) for a call.

Inputs: call_id (required).

aircall_get_integrationA
Read-only

Get information about the integration associated with the current API credentials (only available for OAuth or Aircall-built integrations).

Inputs: no named parameters.

aircall_get_numberA
Read-only

Get detailed information about a specific phone number including users and message configuration.

Inputs: number_id (required).

aircall_get_playbook_resultA
Read-only

Get the playbook result for a call, including adherence score and per-topic results.

Inputs: call_id (required).

aircall_get_predicted_csatA
Read-only

Get the AI-predicted customer satisfaction (CSAT) score for a call.

Inputs: call_id (required).

aircall_get_realtime_transcriptA
Read-only

Get real-time transcription for an ongoing call. Use this during active calls to see live transcription.

Inputs: call_id (required).

aircall_get_registration_statusA
Read-only

Get the registration status for a phone number. Important for compliance in some regions.

Inputs: number_id (required).

aircall_get_sentimentsA
Read-only

Get sentiment analysis for a call. Returns per-participant sentiment values (POSITIVE/NEUTRAL/NEGATIVE).

Inputs: call_id (required).

aircall_get_summaryA
Read-only

Get the AI-generated summary of a call.

Inputs: call_id (required).

aircall_get_tagB
Read-only

Get detailed information about a specific tag.

Inputs: tag_id (required).

aircall_get_teamA
Read-only

Get detailed information about a specific team including all members and numbers.

Inputs: team_id (required).

aircall_get_topicsB
Read-only

Get key topics discussed during a call.

Inputs: call_id (required).

aircall_get_transcriptA
Read-only

Get the transcription of a call. Returns speaker-attributed utterances with timestamps.

Inputs: call_id (required).

aircall_get_userA
Read-only

Get detailed information about a specific user including their numbers and availability.

Inputs: user_id (required).

aircall_get_user_numbersA
Read-only

Get all phone numbers assigned to a specific user (API v2).

Inputs: user_id (required).

aircall_get_webhookA
Read-only

Get detailed information about a specific webhook including its subscribed events.

Inputs: webhook_id (required).

aircall_list_availabilitiesA
Read-only

Get availability status for all users. Useful for routing calls or finding available agents.

Inputs: no named parameters.

aircall_list_callsA
Read-only

List calls with optional filters. Returns paginated call history with details including direction, status, duration, and associated contacts/users.

Inputs: to, from, page, order, +2 more.

aircall_list_contactsA
Read-only

List all contacts with pagination. Returns contact details including phone numbers and emails.

Inputs: to, from, page, order, +1 more.

aircall_list_numbersA
Read-only

List all phone numbers in the account with their configuration and assigned users.

Inputs: page, order, per_page.

aircall_list_tagsA
Read-only

List all tags available for categorizing calls.

Inputs: page, order, per_page.

aircall_list_teamsA
Read-only

List all teams with their members and assigned numbers.

Inputs: page, order, per_page.

aircall_list_usersA
Read-only

List all users in the Aircall account with their availability status and assigned numbers.

Inputs: page, order, per_page.

aircall_list_webhooksA
Read-only

List all configured webhooks. Webhooks send real-time notifications for events like calls, contacts, and user status changes.

Inputs: page, per_page.

aircall_pause_recordingA

Pause recording on an active call. Useful for sensitive information.

Inputs: call_id (required).

aircall_pingA
Read-only

Test connectivity and credentials against the Aircall API. Use this to troubleshoot the connection.

Inputs: no named parameters.

aircall_push_insight_cardA

Push an insight card with contextual info to the agent's Phone app during an ongoing call. Contents are blocks like {type: "title"|"shortText", text: ...} or {type: "link", link: ..., label: ...}.

Inputs: call_id (required), contents (required).

aircall_remove_campaign_numberA
Destructive

Remove a phone number from a user's power dialer campaign.

Inputs: user_id (required), phone_number_id (required).

aircall_remove_user_from_teamA
Destructive

Remove a user from a team.

Inputs: team_id (required), user_id (required).

aircall_resume_recordingA

Resume recording on an active call after it was paused.

Inputs: call_id (required).

aircall_search_callsA
Read-only

Search calls by phone number, tags, user, or number. More flexible than list_calls for finding specific calls.

Inputs: to, from, tags, user_id, +2 more.

aircall_search_contactsA
Read-only

Search contacts by phone number or email. Returns matching contacts.

Inputs: email, phone_number.

aircall_send_agent_messageA

Send a message in an existing agent conversation thread (appears in the Aircall Inbox). Use this to reply to ongoing conversations.

Inputs: to (required), body (required), number_id (required).

aircall_send_messageA

Send an SMS/MMS from an Aircall number, bypassing the Aircall Inbox. The number must have messaging configured.

Inputs: to (required), body (required), number_id (required), media_url.

aircall_start_callA

Initiate an outbound call on behalf of a user. The user's phone will ring first, then connect to the destination.

Inputs: to (required), user_id (required), number_id (required).

aircall_transfer_callA

Transfer an active call to another user.

Inputs: call_id (required), user_id (required).

aircall_trigger_agent_callA

Trigger an outbound call handled by an Aircall AI Voice Agent. The agent must be configured in the Aircall Dashboard with a connected number and first message. Every {{variable}} in the agent's messages must have a matching key in context.

Inputs: agent_id (required), contact_phone (required), idempotency_key (required), context, +1 more.

aircall_unarchive_callA

Unarchive a previously archived call, restoring it to the main call list.

Inputs: call_id (required).

aircall_update_contactA
Destructive

Update an existing contact's basic information.

Inputs: contact_id (required), last_name, first_name, information, +1 more.

aircall_update_emailA
Destructive

Update an email address on a contact.

Inputs: email_id (required), contact_id (required), label, value.

aircall_update_messagesA
Destructive

Update audio messages and music for a phone number (welcome, waiting, voicemail, etc.). Provide URLs to audio files.

Inputs: number_id (required), ivr, closed, waiting, +7 more.

aircall_update_numberB
Destructive

Update a phone number's configuration like name, timezone, or priority.

Inputs: number_id (required), name, priority, time_zone.

aircall_update_phoneA
Destructive

Update a phone number on a contact.

Inputs: phone_id (required), contact_id (required), label, value.

aircall_update_tagB
Destructive

Update an existing tag.

Inputs: tag_id (required), name, color, description.

aircall_update_userC
Destructive

Update a user's profile information.

Inputs: user_id (required), role_id, last_name, first_name, +1 more.

aircall_update_webhookA
Destructive

Update a webhook's URL, events, or active status.

Inputs: webhook_id (required), url, active, events.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 83 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but a few pairs like aircall_send_message vs aircall_send_agent_message and aircall_start_call vs aircall_dial could be confused. Descriptions are specific enough to guide selection, making errors unlikely.

    Naming Consistency4/5

    All tools share the aircall_ prefix and mostly follow a verb_noun snake_case pattern. Minor inconsistencies like aircall_remove_campaign_number (singular) vs aircall_add_campaign_numbers (plural) and standalone verbs like aircall_dial and aircall_ping keep it from being perfect.

    Tool Count1/5

    With 83 tools, this far exceeds the 50+ threshold for extreme count. Even for a comprehensive API wrapper, this is an overwhelming number that reduces coherence and increases cognitive load for agents.

    Completeness4/5

    The tool set covers the major Aircall domains comprehensively: calls, contacts, users, teams, numbers, tags, campaigns, messaging, webhooks, and integration. Minor gaps exist, such as no way to remove tags from a call or list agent message conversations, but core workflows are fully supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers