Aircall MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.4Updated Nov 7, 2026

Read calls, contacts, users, teams and numbers; tag calls and create or update contacts.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Hosted Aircall connector that lets an assistant read calls, contacts, users, teams and numbers, and tag calls or edit contacts.

What you can do
  • Check connectivity and read company details, users and teams
  • List, fetch and search calls, including AI transcription, sentiment, topics, summary and action items
  • List and search contacts in the shared address book, and fetch individual contacts
  • List phone numbers and call tags
  • Create or update contacts, add comments to calls and apply tags to calls
  • Report usage, request a feature, upgrade or cancel the subscription
When to use it
Useful when you want an assistant to answer questions about call activity, pull AI call summaries and follow-ups, look up agents, teams or contacts, or keep the shared address book and call tags up to date without leaving the chat client.
Requirements
Remote MCP endpoint added by URL only; sign-in happens through OAuth, and the login page asks for your Aircall API ID and API token, which are validated and stored per user. No local install, API key header or environment variable is needed. Aircall AI Voice features are needed for transcription, sentiment, topics, summary and action items.
Before you install
Four tools write to Aircall: creating and updating contacts, adding call comments and tagging calls; confirm before running them. The service is metered: the free plan allows 50 tool calls a month, and paid plans are billed through a Stripe checkout link, with no refund for the current period on cancellation. Your Aircall credentials are entered on the provider's login page and stored per user, and call data, including transcripts, passes through the hosted service.

Installation

In SourceWeft

  1. Open Aircall MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Faircall/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "aircall-by-usefulapi": {
      "type": "http",
      "url": "https://aircall.usefulapi.io/mcp"
    }
  }
}

README

Aircall MCP by usefulapi

Use your Aircall account from Claude, Cursor, or any MCP client — read calls, contacts, users, teams and numbers, and tag calls or create and update contacts. Hosted, no local install: connect with your own credentials.

Live endpoint: https://aircall.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://aircall.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http aircall https://aircall.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "aircall": {      "url": "https://aircall.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Aircall credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/aircall/

On first connect you'll provide your Aircall API ID and API token (Integrations & API → API Keys). It is validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
aircall_pingreadPing
aircall_get_companyreadGet company
aircall_list_usersreadList users
aircall_get_userreadGet user
aircall_list_callsreadList calls
aircall_get_callreadGet call
aircall_search_callsreadSearch calls
aircall_list_numbersreadList numbers
aircall_get_numberreadGet number
aircall_list_contactsreadList contacts
aircall_get_contactreadGet contact
aircall_search_contactsreadSearch contacts
aircall_list_tagsreadList tags
aircall_get_tagreadGet tag
aircall_list_teamsreadList teams
aircall_get_teamreadGet team
aircall_get_call_transcriptionreadGet call transcription
aircall_get_call_sentimentsreadGet call sentiments
aircall_get_call_topicsreadGet call topics
aircall_get_call_summaryreadGet call summary
aircall_get_call_action_itemsreadGet call action items
aircall_create_contactwriteCreate contact
aircall_update_contactwriteUpdate contact
aircall_add_call_commentwriteAdd call comment
aircall_tag_callwriteTag call
aircall_usage_statusmetaUsage status (free-tier meter)
aircall_request_featuremetaRequest a missing feature
aircall_upgrademetaUpgrade to Pro or Pro+
aircall_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with aircall_upgrade (it returns a Stripe Checkout link). Cancel any time with aircall_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running aircall_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/aircall/README.md at commit 4046075

Tools

25

aircall_ping

Ping

Health check — verify the API is reachable and the credentials are valid. Aircall REST: GET /ping.

Takes no parameters.

aircall_get_company

Get company

Get details of the authenticated Aircall company (name, plan, usage). Aircall REST: GET /company.

Takes no parameters.

aircall_list_users

List users

List users (agents) in the Aircall company (id, name, email, availability). Aircall REST: GET /users.

Parameterspageper_page

aircall_get_user

Get user

Get a single user (agent) by id. Aircall REST: GET /users/{id}.

Parametersidrequired

aircall_list_calls

List calls

List calls, optionally filtered by a creation-date window and ordered. Aircall REST: GET /calls.

Parameterstofrompageorderper_pagefetch_contact

aircall_get_call

Get call

Get a single call by id. Aircall REST: GET /calls/{id}.

Parametersidrequiredfetch_contact

aircall_search_calls

Search calls

Search calls by a free-text term (e.g. phone number, tag, direction). Aircall REST: GET /calls/search.

Parametersqpageper_page

aircall_list_numbers

List numbers

List the phone numbers owned by the company (id, name, digits, country). Aircall REST: GET /numbers.

Parameterspageper_page

aircall_get_number

Get number

Get a single phone number by id. Aircall REST: GET /numbers/{id}.

Parametersidrequired

aircall_list_contacts

List contacts

List contacts in the shared address book, optionally by creation-date window and order. Aircall REST: GET /contacts.

Parameterstofrompageorderper_page

aircall_get_contact

Get contact

Get a single contact by id. Aircall REST: GET /contacts/{id}.

Parametersidrequired

aircall_search_contacts

Search contacts

Search contacts by a free-text term (e.g. name, phone number, email). Aircall REST: GET /contacts/search.

Parametersqpageper_page

aircall_list_tags

List tags

List the company's call tags (id, name, color). Aircall REST: GET /tags.

Parameterspageper_page

aircall_get_tag

Get tag

Get a single tag by id. Aircall REST: GET /tags/{id}.

Parametersidrequired

aircall_list_teams

List teams

List the company's teams and their members. Aircall REST: GET /teams.

Parameterspageper_page

aircall_get_team

Get team

Get a single team by id. Aircall REST: GET /teams/{id}.

Parametersidrequired

aircall_get_call_transcription

Get call transcription

Get the AI-generated transcription of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/transcription.

Parametersidrequired

aircall_get_call_sentiments

Get call sentiments

Get the AI-generated sentiment analysis of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/sentiments.

Parametersidrequired

aircall_get_call_topics

Get call topics

Get the AI-detected topics of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/topics.

Parametersidrequired

aircall_get_call_summary

Get call summary

Get the AI-generated summary of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/summary.

Parametersidrequired

aircall_get_call_action_items

Get call action items

Get the AI-extracted action items / follow-ups from a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/action_items.

Parametersidrequired

aircall_create_contact

Create contact

Create a new contact in the shared address book. Aircall typically requires at least one of first_name / last_name / company_name. Aircall REST: POST /contacts.

Parametersemailslast_namefirst_nameinformationcompany_namephone_numbers

aircall_update_contact

Update contact

Update fields on an existing contact. Only provided fields are changed. Aircall REST: PUT /contacts/{id}.

Parametersidrequiredemailslast_namefirst_nameinformationcompany_namephone_numbers

aircall_add_call_comment

Add call comment

Add a comment / note to a call. Aircall REST: POST /calls/{id}/comments.

Parametersidrequiredcontentrequired

aircall_tag_call

Tag call

Apply tags to a call by tag id (get ids from aircall_list_tags). Aircall REST: POST /calls/{id}/tags.

Parametersidrequiredtag_idsrequired

Version history

21
  1. v1.36.4LatestNov 7, 2026
  2. v1.35.3Nov 5, 2026
  3. v1.35.2Nov 5, 2026
  4. v1.35.1Nov 4, 2026
  5. v1.35.0Nov 3, 2026
  6. v1.34.1Nov 3, 2026
  7. v1.33.0Nov 1, 2026
  8. v1.31.0Oct 31, 2026
  9. v1.30.0Oct 31, 2026
  10. v1.29.2Oct 30, 2026
  11. v1.29.0Oct 30, 2026
  12. v1.24.0Oct 26, 2026
  13. v1.21.3Oct 25, 2026
  14. v1.21.0Oct 25, 2026
  15. v1.20.0Oct 24, 2026
  16. v1.17.0Oct 23, 2026
  17. v1.16.4Oct 22, 2026
  18. v1.16.3Oct 21, 2026
  19. v1.11.1Oct 9, 2026
  20. v1.10.0Oct 9, 2026
  21. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations