integrations tools aircall
Aircall MCP for your AI agent
Cogny's Aircall integration exposes 32 tools (20 read, 11 write, 1 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
- 20readonly reads data.
- 11writecreates or changes something.
- 1destructivedeletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect Aircall in Cogny. Every Aircall tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
Notes
Aircall connects with an API ID and API Token from Company Settings → Integrations & API → API Keys (the token is shown only once when you create it). Cogny sends them as HTTP Basic auth to api.aircall.io/v1, acting on your whole Aircall company.
Cogny reads calls, transcripts and AI summaries, sentiments, topics, contacts, tags, users, availability, teams, numbers and outbound dialer campaigns, and writes call notes, call tags, contacts, tags, teams and campaign pauses. Starting an outbound call (start_outbound_call) would make the user's Aircall desktop app place a REAL phone call to an external number, so it is refused in code until the call is explicitly confirmed. Cogny never creates or deletes users, deletes recordings or voicemails, or sends SMS/WhatsApp messages.
Known gaps
- Only six months of call history is available, and calls and contacts are capped at 10,000 items per query — pass
from/toUNIX-timestamp windows to reach older ranges. - Aircall rate-limits at 120 requests/minute per company.
- Transcripts, summaries, sentiments and topics are Conversation Intelligence features that need the AI Assist add-on on your plan; without it they return a friendly message.
- Launching an outbound dialer campaign is deliberately not exposed (it needs a compliance acknowledgment) — you can read, track and pause campaigns, not start one.
what each tool does.
Read 20 · only reads data
pingReadCheck that the Aircall API is reachable with the configured credentials.list_callsReadList calls, optionally within a from/to UNIX-timestamp window.get_callReadGet one call by its Aircall call id.search_callsReadSearch calls by direction (inbound|outbound), user_id, phone_number or tags (Aircall tag ids).get_call_transcriptionReadGet the transcription of a call (Conversation Intelligence).get_call_summaryReadGet the AI summary of a call (Conversation Intelligence).get_call_sentimentsReadGet the sentiment analysis of a call (Conversation Intelligence).get_call_topicsReadGet the AI-detected topics of a call (Conversation Intelligence).list_usersReadList the users in your Aircall company.get_users_availabilityReadList each user's availability (availability_status, substatus, wrap-up time) across the company.list_teamsReadList the teams in your Aircall company.get_teamReadGet one team by its Aircall team id.list_contactsReadList the shared contacts in your Aircall company.search_contactsReadSearch the shared contacts in your Aircall company by phone_number, email, or within a from_/to UNIX-timestamp creation window.get_contactReadGet one shared contact by its Aircall contact id.list_tagsReadList the tags in your Aircall company.list_numbersReadList the phone numbers associated with your Aircall company.list_campaignsReadList the outbound dialer campaigns in your Aircall company. `status` filters by draft|in_progress|paused|completed|archived (comma-separated for several).get_campaignReadGet one outbound dialer campaign by its Aircall campaign id (a UUID).get_campaign_statisticsReadGet progress statistics for an outbound dialer campaign — how many contacts are done, how many remain, and how connected calls went.
Write 11 · creates or changes something
create_contactWriteCreate a shared contact in Aircall. `first_name` and at least one `phone_number` (E.164 or any dialable format) are required; Aircall normalizes the number.update_contactWriteUpdate a shared contact's name/company/information fields.add_contact_phone_numberWriteAdd a phone number to a shared contact. `value` is the number (any dialable format; Aircall normalizes it).add_contact_emailWriteAdd an email to a shared contact.create_tagWriteCreate a tag in Aircall. `name` must be unique and non-blank; `color` must be a hex value like '#00B388'.add_call_commentWriteAdd a note (comment) to a call. `content` is the note text.add_call_tagWriteApply one or more existing tags to a call.create_teamWriteCreate a team in Aircall. `name` must be unique and at most 64 characters.add_user_to_teamWriteAdd a user to a team.start_outbound_callWritePlace a REAL phone call to `to` from `user_id`'s Aircall app, refused until you pass `confirm=True` after the user approves. `number_id` is the Aircall number to call from, `to` the destination in E.164.pause_campaignWritePause an in_progress outbound dialer campaign — dialling stops for new attempts, and a call already in flight is allowed to finish.
Destructive 1 · deletes, removes or replaces something
remove_user_from_teamDestructiveRemove a user from a team.
Exact input schemas come from tools/list once Aircall is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.