Aircall MCP. Manage contacts, calls, and numbers through conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Aircall MCP Server gives your AI client control over your cloud phone system. Your agent can list calls, manage contacts, check team availability, and audit phone numbers directly from chat.
It lets you run complex communications tasks—like finding a client's last call details or checking if a rep is free—without touching the Aircall UI.
What your AI agents can do
Create contact
Adds a new contact record to your Aircall system.
Get call details
Retrieves technical details for a specific call, including metadata and duration.
Get number details
Gets the technical configuration details for a specific phone number.
The agent lists call records and gets technical details for specific calls, including durations and participants.
The agent creates new contacts or searches existing ones by name or phone number.
The agent lists team members and checks individual user availability status.
The agent retrieves technical configurations and lists all active phone numbers attached to your account.
The agent lists all available Aircall teams and members for organizational visibility.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Aircall MCP Server: 10 Tools for Communication Management
These tools allow your AI agent to read, write, and audit all aspects of your Aircall account, from contact creation to call logging.
019d754acreate contact
Adds a new contact record to your Aircall system.
019d754aget call details
Retrieves technical details for a specific call, including metadata and duration.
019d754aget number details
Gets the technical configuration details for a specific phone number.
019d754aget user details
Checks the current availability status of a specific team member.
019d754alist calls
Retrieves a list of recent call logs for the team.
019d754alist contacts
Lists all contacts stored within your Aircall account.
019d754alist numbers
Lists all phone numbers configured for your Aircall account.
019d754alist teams
Lists all teams set up in your Aircall workspace.
019d754alist users
Lists all team members associated with your Aircall account.
019d754asearch contacts
Searches your contact list by entering a phone number or name.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Aircall, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI client gets full control over your Aircall phone system. Your agent can list calls, manage contacts, check team availability, and audit phone numbers right from the chat. It lets you run complex comms tasks—like finding a client's last call details or checking if a rep's free—without touching the Aircall UI.
Audit Call Logs: Your agent can list all recent calls using list_calls, and then grab technical details for any specific call with get_call_details, getting things like the duration and who was on the line.
Manage Contacts: You can make new contacts with create_contact, or search your existing list by name or phone number using search_contacts; you can also see every contact stored in the system by running list_contacts.
Check Team Status: Your agent lists every team in your workspace using list_teams, and it can list all team members with list_users; you can then check if a specific team member is available using get_user_details.
Verify Phone Numbers: You can list all phone numbers attached to your account using list_numbers, and you can check the technical setup details for any single number with get_number_details.
System Overview: Your agent can list every available team using list_teams and list all users in the system with list_users.
How Aircall MCP Works
- 1 Subscribe to this server and provide your Aircall API ID and API Token.
- 2 Your AI client sends a natural language request (e.g., 'Check Jane Smith's availability').
- 3 The agent maps the request to the correct tool (e.g.,
get_user_details) and executes the action, returning the result to your chat interface.
The bottom line is that your agent talks to Aircall's API, and you get the answer back in a single conversation thread.
Who Is Aircall MCP For?
This is for Ops Leads and Support Managers who spend too much time manually checking dashboards. If you need to audit call volumes, update a contact list, or check who's available before making a call, this saves the clicks. It centralizes communication platform management.
Uses the agent to quickly look up a customer's full contact history and retrieve call recordings to resolve complex issues.
Runs reports on team call volumes and checks phone number configurations to ensure system compliance.
Manages contact records and uses the agent to update CRM data after a client call, logging details without leaving the chat.
What Changes When You Connect
- See who's available before you call. Use
get_user_detailsto check if a specific user is 'Busy' or 'Available', stopping wasted time trying to connect with someone offline. - Audit everything. Run
list_callsto get a list of recent call logs, and then useget_call_detailsto pull specific recordings or metadata from any single call. - Keep your data clean. Use
create_contactandsearch_contactsto ensure every client contact record is up-to-date before your next meeting. - Understand your infrastructure. Run
list_numbersto see every phone number assigned, andget_number_detailsto verify its technical setup. - Track team structure.
list_teamsandlist_userslet you map out who belongs to what department, simplifying large-scale operational oversight. - Reduce context switching. Instead of jumping between the Aircall UI, your CRM, and a spreadsheet, the agent pulls call history and contact details in one chat window.
Real-World Use Cases
Client follow-up after a sales pitch
A sales rep needs to know if a prospect's contact info changed since last week. They ask the agent to search_contacts using the known phone number. The agent finds the record, confirms the current email, and then runs create_contact to ensure the CRM is updated before the next call.
Investigating a service outage
A support manager needs to know which agents were active during an incident. They ask the agent to list_calls for the last 24 hours. The agent provides the logs, and the manager uses list_users to verify who was on shift during that timeframe.
Onboarding a new team member
A manager needs to set up a new rep. They use the agent to list_teams to identify the correct department. Then, they use list_users to assign the new user and verify their initial access rights via get_user_details.
Compliance audit of phone lines
An Ops Lead needs to verify that all department lines are correctly configured. They run list_numbers to get all numbers, and then iterate through them using get_number_details to confirm the technical settings match the required standard.
The Tradeoffs
Manual dashboard cross-referencing
Logging into Aircall, pulling the user list, opening the call logs, finding the relevant call, and then copy-pasting the contact details into a spreadsheet.
→
Let your agent handle it. Ask the agent to list_calls first, and then use get_call_details and list_contacts to pull the exact metadata you need, all without leaving your chat window.
Assuming data freshness
Pulling contact details from a cached view and assuming they are current, only to find out the client changed their phone number last week.
→
Always confirm the data with the agent. Use search_contacts to verify the phone number and create_contact if the record is missing or needs updating.
Overloading the API with batch requests
Writing a script that calls list_calls and then attempts to call get_call_details for hundreds of calls sequentially, causing timeouts.
→
Use the agent to get the initial list (list_calls), and then let it handle the subsequent detail lookups (get_call_details) in structured batches.
When It Fits, When It Doesn't
Use this if your job involves coordinating multiple communication data sources: call logs, user status, and contact records. It’s best for Support Leads and Ops personnel who need to audit processes. Don't use this if you only need to write a single, simple contact record—just use the create_contact tool. Don't use it if your primary need is advanced reporting on all historical data; use a dedicated business intelligence tool instead. This server is about actionable, real-time data retrieval and management.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Aircall. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Finding who spoke to whom and when shouldn't take a deep dive into multiple dashboards.
Today, finding a simple customer history is a multi-step process. You check the main Aircall dashboard for call logs. Then, you click into each call to find the participant details. If you need to check the contact record, you have to open a completely different tab and manually search the contact database. It's a mess of tabs and copy-pasting.
With the Aircall MCP Server, you just ask. You ask your agent to 'What was the last interaction with Acme Corp?' and it runs the necessary tools—like `list_calls` and `search_contacts`—and gives you a single, summarized answer. The whole process moves from clicks to a single prompt.
Aircall MCP Server: Manage contact, call, and number data from chat.
The biggest time sink is checking if a user is actually free to talk. You have to check the user list, then check their status, and if they are available, you have to verify their number details before calling. These checks are disconnected and slow.
Now, you just ask the agent to 'Check if Jane Smith is available and what her number is.' It runs `get_user_details` and `get_number_details` in sequence and gives you the full status. The difference is that the process is automated, not manual.
Common Questions About Aircall MCP
How do I use the `list_calls` tool to find call records? +
You simply ask your agent to 'List the last 10 calls.' The agent executes list_calls and returns the call logs, including call IDs, dates, and participants.
Can I use `search_contacts` to find a client's history? +
Yes. You ask the agent to search_contacts using the phone number. The agent finds the match and gives you details, allowing you to proceed with follow-up actions.
What is the purpose of the `get_user_details` tool? +
The get_user_details tool checks if a specific user is available for calls. It returns their current status (e.g., 'Busy', 'Available') and average call duration.
How does `create_contact` work? +
You tell the agent to create a new contact, providing the name and phone number. The agent then executes create_contact and confirms the record is added to Aircall.
Can I use `list_numbers` to check all my phone lines? +
Yes. The list_numbers tool retrieves a list of every phone number configured in your Aircall account, which you can then audit.
How do I use the `list_users` tool to check team availability and assignments? +
The list_users tool retrieves a roster of team members and their status. It lets you see who's available, who's assigned to which department, and helps managers plan outreach.
What information can I get using the `get_call_details` tool? +
This tool pulls specific technical data about a single call. You get details like recording links, precise start/end times, and participant metadata for deep auditing.
Can I use `list_teams` to understand department structure? +
Yes, list_teams returns a list of all existing teams in your Aircall account. You can use this list to verify department names or check team membership.
How do I find my Aircall API ID and Token? +
Log in to your Aircall Dashboard, navigate to Integrations & API > API keys, and create a new key. You will see both the api_id and api_token there.
Can I listen to call recordings via the agent? +
The get_call_details tool provides the URL to the call recording if available. Your agent can retrieve this metadata, and you can access the link to listen to the audio.
Does this support checking user availability? +
Yes! Use the get_user_details tool. It returns the current availability status (Available, Busy, or Offline) for any team member in your account.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
MessageBird
Manage your global communications — send SMS and audit contacts via AI.
Polaria
Unify your customer support with an AI agent that manages Polaria conversations, contacts, and FAQ retrieval.
Five9
Monitor agents, manage call states, and track real-time contact center stats via AI agents with Five9.
You might also like
Upzelo
Reduce subscription churn with personalized retention offers that intercept cancellations and win back customers at the exit point.
IBGE Nomes — Nomes do Brasil
Discover the history behind every Brazilian name: birth frequency by decade since the 1930s, national popularity rankings, and regional trends — the viral dataset that captivated 200 million Brazilians.
Postmark
Automate transactional email delivery via Postmark — manage servers, templates, and bounces directly from any AI agent.