Verified

Aircall MCP Server

Access Aircall data like calls, contacts, and AI-generated insights in your AI assistant.

Data last scanned today · Reviewed today

5321 tools★ 0TypeScriptMIT

Overview

The Aircall MCP Server provides a read-only interface for the Aircall REST API, enabling AI assistants to pull call history, contact details, and conversation intelligence. It processes data locally using stdio transport to ensure credentials and communications stay on your machine without persistence or server-side logging. The tool features 21 distinct endpoints, including specialized support for retrieving call summaries, sentiments, topics, and action items. Sensitive media URLs for recordings and voicemails are excluded by default, requiring explicit user opt-in to access.

Our verdict

With a security score of 33/100, this tool carries a high risk level. The score reflects that the project is community-maintained rather than vendor-official and lacks an independent audit of its authentication methods and read-only implementation. Given the single contributor and zero stars, this server is best suited for experienced developers who can independently verify the source code and handle Aircall API credentials securely in their environment.

Supports 21 distinct read-only Aircall API endpoints.
Excludes sensitive media URLs by default.
Minimal supply-chain surface with only two direct dependencies.
Implements local stdio transport to avoid external web proxies.

Community-maintained project lacking official Aircall endorsement.
Security architecture has not yet undergone professional review.
Single-contributor repository increases bus-factor risk.
Authentication process remains unvetted for potential exposure.

Setup

Claude Desktop

{
  "mcpServers": {
    "aircall-mcp": {
      "args": [
        "-y",
        "aircall-mcp"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
aircall_ping	Checks the connectivity to the Aircall API.	low
aircall_get_company	Retrieves information about the Aircall company.	low
aircall_list_users	Lists all users in the Aircall account.	low
aircall_get_user	Retrieves information for a specific user by ID or email.	low
aircall_list_calls	Lists calls from the Aircall account.	low
aircall_get_call	Retrieves details for a specific call by ID.	low
aircall_search_calls	Searches for calls based on criteria.	low
aircall_get_transcription	Retrieves the transcription for a specific call.	low
aircall_get_sentiments	Retrieves sentiment analysis for a specific call.	low
aircall_get_topics	Retrieves topics discussed in a specific call.	low

Compatibility

Client	Local	Docker	Remote	Read-only
ChatGPT
Claude Desktop
Cursor
VS Code
Windsurf

Frequently asked questions

›What are the system requirements for running the Aircall MCP server?

You need Node.js version 20 or newer and a valid Aircall API ID and token pair generated from your Aircall Dashboard.

›Does this server store any of my Aircall data?

No, the server is designed without persistence. No responses, transcripts, or contact details are written to disk.

›Why are some media URLs, such as recording links, missing from the results?

Media URLs are omitted by default for security. You must use explicit opt-in options like include_recording_urls if you need to access those specific assets.

›Are there limitations to the data I can retrieve from the Aircall API?

The API restricts access to the last six months of call history and supports a maximum of 10,000 items when paginating. You may need to use date windows to retrieve records beyond these constraints.

›Can I configure the server to avoid storing my credentials in plain text?

Yes, if using the Pi MCP adapter on macOS, you can store your credentials in the Keychain and reference them in your configuration using commands prefixed with an exclamation mark.

›What happens if I hit the API rate limit?

The server allows 120 API requests per minute per company and will automatically retry once if a 429 rate-limit response is received.