How to integrate Aircall MCP with Hermes

Add a phone number or an email address to an existing Aircall contact.

Add a User to a Team (membership change).

Add a comment/note to a Call (max 5 comments per call; emojis are stripped).

Create a shared Aircall contact.

Create a Tag.

Create a new Team.

Create an Aircall user and send them a real invitation email, consuming a licensed seat.

Create an Aircall webhook targeting a public HTTPS URL.

Request permanent deletion of a Call's audio recording or voicemail, for compliance or data governance.

Permanently delete a shared Contact and all of its phone numbers and email addresses.

Permanently remove one phone number or email address from an Aircall contact.

Delete a Tag by id.

Delete a Team by id.

Permanently delete a User.

Permanently delete an Aircall webhook.

Retrieve a single Call by id, with optional contact / short-url / timeline enrichment via the fetch_* flags.

Retrieve information about the connected Aircall company (name, users_count, numbers_count).

Retrieve a single shared Contact by id, with its nested phone_numbers[] and emails[].

Retrieve a single Aircall phone Number by its numeric id.

Check whether an Aircall phone number is registered for compliance (10DLC or other regulatory registration) by reading the `status` field.

Retrieve a single Tag by id.

Retrieve a single Team by id, including its member users.

Retrieve one Aircall user by numeric id or by email address.

Check the current availability of one User.

Retrieve one Aircall webhook by its UUID or legacy numeric id.

List the account's calls in chronological order, covering about 6 months of history and at most 10,000 items via pagination.

List all shared Contacts (hard-capped at 10,000 items via pagination — window past with the `from` timestamp).

List all Aircall phone Numbers in the account.

List all Tags in the account.

List all Teams in the account.

List all Aircall Numbers assigned to a specific User (V2, paginated).

List the users in the Aircall account, one page at a time with a next_cursor to continue.

List the detailed availability of all Users (whether each user is available/offline/on a call, etc.

List webhook subscriptions accessible to the connected Aircall company.

Display contextual title, short text, links, or Aircall user details to the agent handling an ongoing call.

Remove a User from a Team (membership change).

Find calls matching any combination of direction (inbound or outbound), user_id, phone_number and tag ids, optionally narrowed to a from/to date window.

Search shared Contacts by phone_number and/or email (optionally within a from/to date window).

Pause or resume recording on an ongoing Aircall call.

Place a real, billable outbound phone call from an Aircall user's desktop Workspace to an external number.

Tag a Call with one or more existing Tag ids (create tags first with AIRCALL_CREATE_TAG).

Cold-transfer a call that is live right now to one user, one team, or one external phone number.

Update a Contact's core fields (first_name, last_name, company_name, information).

Update one phone number or email address that is already on an Aircall contact.

Update at least one mutable Number field: name changes its display name; availability_status changes the first Time Rule widget and can open or close call routing; live_recording_activated enables or disables inbound and outbound recording, and audio missed while disabled cannot be recovered; priority changes routing priority; messages replaces or clears supplied Music & Messages audio slots heard by live callers.

Update a Tag (PUT, full replace).

Update an existing Aircall user's name, availability_status, substatus, roles or wrap-up time in place.

Update an Aircall webhook's URL, name, active state, or event subscriptions.