Aircall MCP Server
Provides 83 tools for interacting with the Aircall Public API, including calls, transcriptions, AI insights, contacts, SMS, users, teams, numbers, tags, webhooks, messages, dialer, and company settings.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Aircall MCP Server Show me my recent call transcripts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Aircall MCP Server
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
Claude Desktop — one-click extension (recommended)
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.mcpbInstall it:
Share
aircall-mcp.mcpbwith your team (Slack, Drive, or this repo's Releases).Double-click it (or Claude Desktop → Settings → Extensions → Advanced settings → Install extension…).
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.
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,contactsRelated 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 |
|
| Aircall API ID (required) |
|
| Aircall API token (required) |
|
| Expose only read tools (36) |
|
| Comma-separated tools or categories; |
Notes:
Authentication is HTTP Basic with the org-level
api_id:api_tokenpair.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 toolsaircall_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_availabilityARead-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_campaignADestructive
Delete a user's power dialer campaign.
Inputs: user_id (required).
aircall_delete_configADestructive
Delete the messaging configuration for an Aircall number.
Inputs: number_id (required).
aircall_delete_contactADestructive
Delete a contact. This action cannot be undone.
Inputs: contact_id (required).
aircall_delete_emailADestructive
Delete an email address from a contact.
Inputs: email_id (required), contact_id (required).
aircall_delete_phoneADestructive
Delete a phone number from a contact.
Inputs: phone_id (required), contact_id (required).
aircall_delete_recordingADestructive
Permanently delete the recording of a call. This cannot be undone.
Inputs: call_id (required).
aircall_delete_tagADestructive
Delete a tag. Existing calls with this tag will lose it.
Inputs: tag_id (required).
aircall_delete_teamADestructive
Delete a team. Users in the team will not be deleted.
Inputs: team_id (required).
aircall_delete_userADestructive
Delete a user from Aircall. This action cannot be undone.
Inputs: user_id (required).
aircall_delete_voicemailADestructive
Permanently delete the voicemail of a call. This cannot be undone.
Inputs: call_id (required).
aircall_delete_webhookADestructive
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_itemsARead-only
Get AI-detected action items from a call.
Inputs: call_id (required).
aircall_get_callARead-only
Get detailed information about a specific call including comments, tags, participants, and recording URLs.
Inputs: call_id (required).
aircall_get_campaignARead-only
Get a user's active power dialer campaign. Each user has at most one active campaign.
Inputs: user_id (required).
aircall_get_campaign_numbersARead-only
Get the phone numbers in a user's power dialer campaign.
Inputs: user_id (required), page, per_page.
aircall_get_companyARead-only
Get information about the Aircall company account including user and number counts.
Inputs: no named parameters.
aircall_get_configARead-only
Get the messaging configuration for an Aircall number.
Inputs: number_id (required).
aircall_get_contactARead-only
Get detailed information about a specific contact.
Inputs: contact_id (required).
aircall_get_custom_summaryARead-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_evaluationsARead-only
Get call quality evaluations (scorecards, feedback, scores) for a call.
Inputs: call_id (required).
aircall_get_integrationARead-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_numberARead-only
Get detailed information about a specific phone number including users and message configuration.
Inputs: number_id (required).
aircall_get_playbook_resultARead-only
Get the playbook result for a call, including adherence score and per-topic results.
Inputs: call_id (required).
aircall_get_predicted_csatARead-only
Get the AI-predicted customer satisfaction (CSAT) score for a call.
Inputs: call_id (required).
aircall_get_realtime_transcriptARead-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_statusARead-only
Get the registration status for a phone number. Important for compliance in some regions.
Inputs: number_id (required).
aircall_get_sentimentsARead-only
Get sentiment analysis for a call. Returns per-participant sentiment values (POSITIVE/NEUTRAL/NEGATIVE).
Inputs: call_id (required).
aircall_get_summaryARead-only
Get the AI-generated summary of a call.
Inputs: call_id (required).
aircall_get_tagBRead-only
Get detailed information about a specific tag.
Inputs: tag_id (required).
aircall_get_teamARead-only
Get detailed information about a specific team including all members and numbers.
Inputs: team_id (required).
aircall_get_topicsBRead-only
Get key topics discussed during a call.
Inputs: call_id (required).
aircall_get_transcriptARead-only
Get the transcription of a call. Returns speaker-attributed utterances with timestamps.
Inputs: call_id (required).
aircall_get_userARead-only
Get detailed information about a specific user including their numbers and availability.
Inputs: user_id (required).
aircall_get_user_numbersARead-only
Get all phone numbers assigned to a specific user (API v2).
Inputs: user_id (required).
aircall_get_webhookARead-only
Get detailed information about a specific webhook including its subscribed events.
Inputs: webhook_id (required).
aircall_list_availabilitiesARead-only
Get availability status for all users. Useful for routing calls or finding available agents.
Inputs: no named parameters.
aircall_list_callsARead-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_contactsARead-only
List all contacts with pagination. Returns contact details including phone numbers and emails.
Inputs: to, from, page, order, +1 more.
aircall_list_numbersARead-only
List all phone numbers in the account with their configuration and assigned users.
Inputs: page, order, per_page.
aircall_list_tagsARead-only
List all tags available for categorizing calls.
Inputs: page, order, per_page.
aircall_list_teamsARead-only
List all teams with their members and assigned numbers.
Inputs: page, order, per_page.
aircall_list_usersARead-only
List all users in the Aircall account with their availability status and assigned numbers.
Inputs: page, order, per_page.
aircall_list_webhooksARead-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_pingARead-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_numberADestructive
Remove a phone number from a user's power dialer campaign.
Inputs: user_id (required), phone_number_id (required).
aircall_remove_user_from_teamADestructive
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_callsARead-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_contactsARead-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_contactADestructive
Update an existing contact's basic information.
Inputs: contact_id (required), last_name, first_name, information, +1 more.
aircall_update_emailADestructive
Update an email address on a contact.
Inputs: email_id (required), contact_id (required), label, value.
aircall_update_messagesADestructive
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_numberBDestructive
Update a phone number's configuration like name, timezone, or priority.
Inputs: number_id (required), name, priority, time_zone.
aircall_update_phoneADestructive
Update a phone number on a contact.
Inputs: phone_id (required), contact_id (required), label, value.
aircall_update_tagBDestructive
Update an existing tag.
Inputs: tag_id (required), name, color, description.
aircall_update_userCDestructive
Update a user's profile information.
Inputs: user_id (required), role_id, last_name, first_name, +1 more.
aircall_update_webhookADestructive
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
Scored across 83 tools
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.
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.
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.
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
Related MCP Connectors
Hosted CallRail MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Aircall MCP server for ChatGPT, Claude and any AI agent: list calls, get call summary, tag call, add call note, send SMS, search contacts and create contact in your own Aircall account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Aircall yourself; Cotlet does not store your password and you need no Aircall API key. About the official Aircall API: Aircall has a full public REST API and an official MCP server in beta (checked 23 Oct 2026). The API needs a key that a company Admin creates under Company Settings > API Keys, and it reads and writes calls, tags, comments, contacts and messages. Setup and FAQ: https://cotlet.dev/integrations/aircall-api-mcp-server
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that exposes Intercom tools to Claude Desktop and sends a daily support report via email.-
- AlicenseAqualityAmaintenanceMCP server for the BoondManager API, enabling Claude to search, create, and modify records across 36 domains with 158 tools.238423 npm21Apache 2.0
- AlicenseAqualityDmaintenanceAn MCP server that lets you schedule AI phone calls and manage Leximo assignments directly from Claude Desktop or Claude Code.1345 npm2MIT
- FlicenseBqualityDmaintenanceMCP server for Cal.com scheduling, providing ~70 tools to manage schedules, event types, bookings, calendars, webhooks, and teams. Enables natural language control of Cal.com from Claude or any MCP-compatible client.68-