usefulapi

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

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://aircall.usefulapi.io/mcp
Authenticate with Aircall when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "aircall": {
      "url": "https://aircall.usefulapi.io/mcp"
    }
  }
}

live27 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 27

Tool	Type	What it does
`aircall_ping`	read	Ping Health check — verify the API is reachable and the credentials are valid. Aircall REST: GET /ping.
`aircall_get_company`	read	Get company Get details of the authenticated Aircall company (name, plan, usage). Aircall REST: GET /company.
`aircall_list_users`	read	List users List users (agents) in the Aircall company (id, name, email, availability). Aircall REST: GET /users.
`aircall_get_user`	read	Get user Get a single user (agent) by id. Aircall REST: GET /users/{id}.
`aircall_list_calls`	read	List calls List calls, optionally filtered by a creation-date window and ordered. Aircall REST: GET /calls.
`aircall_get_call`	read	Get call Get a single call by id. Aircall REST: GET /calls/{id}.
`aircall_search_calls`	read	Search calls Search calls by a free-text term (e.g. phone number, tag, direction). Aircall REST: GET /calls/search.
`aircall_list_numbers`	read	List numbers List the phone numbers owned by the company (id, name, digits, country). Aircall REST: GET /numbers.
`aircall_get_number`	read	Get number Get a single phone number by id. Aircall REST: GET /numbers/{id}.
`aircall_list_contacts`	read	List contacts List contacts in the shared address book, optionally by creation-date window and order. Aircall REST: GET /contacts.
`aircall_get_contact`	read	Get contact Get a single contact by id. Aircall REST: GET /contacts/{id}.
`aircall_search_contacts`	read	Search contacts Search contacts by a free-text term (e.g. name, phone number, email). Aircall REST: GET /contacts/search.
`aircall_list_tags`	read	List tags List the company's call tags (id, name, color). Aircall REST: GET /tags.
`aircall_get_tag`	read	Get tag Get a single tag by id. Aircall REST: GET /tags/{id}.
`aircall_list_teams`	read	List teams List the company's teams and their members. Aircall REST: GET /teams.
`aircall_get_team`	read	Get team Get a single team by id. Aircall REST: GET /teams/{id}.
`aircall_get_call_transcription`	read	Get call transcription Get the AI-generated transcription of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/transcription.
`aircall_get_call_sentiments`	read	Get call sentiments Get the AI-generated sentiment analysis of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/sentiments.
`aircall_get_call_topics`	read	Get call topics Get the AI-detected topics of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/topics.
`aircall_get_call_summary`	read	Get call summary Get the AI-generated summary of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/summary.
`aircall_get_call_action_items`	read	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.
`aircall_create_contact`	write	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.
`aircall_update_contact`	write	Update contact Update fields on an existing contact. Only provided fields are changed. Aircall REST: PUT /contacts/{id}.
`aircall_add_call_comment`	write	Add call comment Add a comment / note to a call. Aircall REST: POST /calls/{id}/comments.
`aircall_tag_call`	write	Tag call Apply tags to a call by tag id (get ids from aircall_list_tags). Aircall REST: POST /calls/{id}/tags.
`aircall_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached.
`aircall_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to Pro for unlimited tool calls, monthly ($9) or yearly ($90). Returns a Stripe Checkout link.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.