Aircall MCP. Manage Contacts, Calls, and Team Status in Plain Language
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 manages your entire cloud phone system through natural language conversation. Your agent can read call logs, manage shared contacts, check team availability, and audit number configurations.
Stop switching between dashboards; get all communication data in one place.
What your AI agents can do
Create contact
Adds a brand new contact record to your Aircall address book.
Get call details
Retrieves the specific technical details about any past call.
Get number details
Fetches the detailed configuration of an Aircall phone number.
List and retrieve technical details for past calls, including who was involved and how long they lasted.
Create new records or search your existing database of contacts by name or phone number.
See which team members are available, busy, or assigned to specific departments.
Get the technical configuration and details for every phone number tied to your account.
Retrieve a list of all active teams or departments within your organization's Aircall setup.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Aircall MCP with 10 Tools
These tools let you programmatically access and modify all core data within your Aircall account, from user directories to call history.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Aircall on Vinkius019d754acreate contact
Adds a brand new contact record to your Aircall address book.
019d754aget call details
Retrieves the specific technical details about any past call.
019d754aget number details
Fetches the detailed configuration of an Aircall phone number.
019d754aget user details
Checks a specific user's current availability status within the team.
019d754alist calls
Retrieves a list of recent call logs for auditing purposes.
019d754alist contacts
Provides a simple listing of all contacts stored in your Aircall account.
019d754alist numbers
Gives you an overview list of all phone numbers assigned to the account.
019d754alist teams
Lists every team or departmental group defined in Aircall.
019d754alist users
Retrieves a directory listing of all active users and members.
019d754asearch contacts
Searches your contact database using a specific phone number or name query.
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,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ 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
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.
Dealing with siloed call and contact data today requires constant clicking.
Right now, if you want to know about a client, you usually have to jump between the CRM dashboard for their history, the team roster page for who answered the calls, and then check an admin panel just to verify which phone number was used. It's a painful cycle of logging into five different places.
With this MCP, your agent handles that entire sequence in one prompt. You ask it to look up contact details, then cross-reference that with team availability using `get_user_details`, and finally pull the relevant call metadata via `list_calls`. The data comes back organized, ready for action.
Aircall MCP gives you full control over your contact records.
You don't have to manually create new entries or rely on someone else updating the shared address book. You can use `create_contact` directly, and then immediately follow up by verifying that number with `get_number_details`. The process is instant.
It’s simple: you tell your agent who needs adding, and it handles the record creation and verification in a single conversational turn.
What you can do with this MCP connector
This connector gives your AI client deep access to your Aircall business phone system. You tell the agent what you need—whether it's checking a colleague’s status or digging into call recordings—and it handles the whole sequence of tasks for you. It centralizes everything: contact management, team structure, and communication history.
Instead of manually looking up details across different tabs, your agent retrieves structured data by calling specific endpoints like list_calls or search_contacts. Everything runs through Vinkius's catalog system, so you connect once and get access to all the operational tools needed for a modern support workflow. You can quickly check team assignments using list_users, verify phone number setups with get_number_details, and even build new contacts using create_contact—all via simple conversation.
019d754a-bbb8-7025-b92c-1dea6faf717f 
How Aircall MCP Works
- 1 Subscribe to this MCP and provide the necessary API ID and token for your Aircall account.
- 2 Connect the credentials to your preferred AI client (like Claude or Cursor).
- 3 Start by prompting your agent with a natural language request, such as 'List all active users in the Sales team,' and it executes the required tool calls.
The bottom line is you talk to your agent naturally, and it talks to Aircall for you, returning structured data in real time.
Who Is Aircall MCP For?
This MCP serves anyone whose job involves managing communication flow or needing a single source of truth for call history. It’s perfect for the operations lead who is done clicking through ten different dashboards to check basic data, and the support agent who needs instant context on every customer interaction.
Uses this MCP to quickly look up call recordings or retrieve participant metadata when resolving a complex service inquiry.
Checks team availability and audits call volumes across multiple users without having to manually pull reports for each person.
Verifies phone number configurations and manages user assignments directly through command prompts, ensuring system accuracy.
What Changes When You Connect
- Review call logs efficiently. Instead of navigating the dedicated logging dashboard, you simply ask your agent to use
list_callsand get summarized data immediately. - Centralize contact information. You can create new records using
create_contactor find existing ones quickly withsearch_contacts, eliminating the need for multiple manual lookups. - Understand team availability instantly. Use
get_user_detailsto check if a colleague is free before initiating a call, saving time and preventing dropped calls. - Audit system health easily. Verify phone number setups using
get_number_detailsor listing all numbers withlist_numberswithout diving into complex admin portals. - Streamline team oversight. You can check departmental assignments by calling
list_usersor view the full organizational structure vialist_teamsin one go.
Real-World Use Cases
Investigating a Missed Call
A sales rep needs to know who called back yesterday. They prompt their agent: 'What calls were logged for John Doe last week?' The agent uses list_contacts and then search_contacts, returning all relevant call metadata so the rep can follow up without manual searching.
Onboarding a New Team Member
An operations lead needs to set up a new user account. They first use list_users to check existing roles, then use get_number_details to verify the assigned line before creating and updating records via create_contact.
Post-Meeting Followup
A support agent finishes a call. They ask their agent to summarize the interaction by looking up the contact's history using search_contacts, allowing them to update internal notes and CRM data immediately after hanging up.
System Readiness Check
The manager needs to confirm all departmental phones are configured correctly before a major campaign launch. They use list_teams followed by multiple calls to get_number_details, confirming every line is active and assigned.
The Tradeoffs
Manual Dashboard Drilling
A user has to click into the 'Call Logs' tab, then filter by date, then export a CSV. They repeat this process for three different departments.
→
Instead, ask your agent to use list_calls and specify the timeframe or department. The system retrieves all necessary metadata directly without any clicking or exporting.
Guessing Contact Details
A user remembers a client's name but not their phone number, so they send an email to guess. This wastes time and often fails.
→
Use the search_contacts tool with partial information or simply provide the known details. The agent finds the correct record immediately using its dedicated search endpoint.
Unverified Phone Lines
A new hire is assigned a number, but nobody checks if the line is active or correctly configured before they try to use it.
→
Always run get_number_details on any newly assigned phone number. This verifies its technical configuration status before anyone tries to make a call.
When It Fits, When It Doesn't
Use this MCP if your workflow relies heavily on maintaining accurate, up-to-date records of who called whom, when they were available, and what the team structure is. You need programmatic access to data like call metadata (get_call_details) or user status (get_user_details). Don't use it if you just want a simple list of names; in that case, list_contacts is enough. But if you need context—like knowing why the contact was called (e.g., checking their history)—you need this full set of tools.
Common Questions About Aircall MCP
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.
If I use the `create_contact` tool, does it check for existing contacts before adding a new one? +
Yes. The MCP first checks if a contact with that phone number or email already exists in your Aircall account. If it finds a match, it prevents creating a duplicate entry and lets you update the record instead.
What specific metadata can I retrieve using `get_call_details`? +
This tool provides deep technical information on calls, including SIP headers, connection IDs, and exact timestamps. It’s for auditing or troubleshooting, not just a summary of who called whom.
When should I use `list_numbers` versus the `get_number_details` tool? +
list_numbers gives you a quick overview and status report of all your assigned lines. You must run get_number_details when you need specific configuration data, like port settings or technical features.
How can I narrow down user results by department using the `list_users` tool? +
You provide a team ID as an argument to list_users. This filters out all other employees and returns only the members assigned to that specific Aircall team.
What fields can I use to filter results when calling `search_contacts`? +
The search_contacts tool accepts parameters for name, phone number, or email. You can combine these filters—for instance, searching by a specific phone prefix and a partial name.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.