Aircall MCP Server

MCP server for the Aircall Public API — 83 tools for calls, transcriptions, AI insights, contacts, SMS, users, teams, and more. Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible AI assistant. Maintained by Cassia Research.

Every tool is verified against the official Aircall API reference. Tools carry MCP annotations (readOnlyHint, destructiveHint, titles), so clients like Claude Desktop can group read-only tools and gate destructive ones.

Not an official Aircall product. This is a community server built and maintained by Cassia Research.

Installation

Claude Desktop — one-click extension (recommended)

This is our default integration path. No Node.js or config-file editing required for end users — Claude Desktop runs the server on its own bundled runtime.

Build the extension:

npm install
npm run bundle   # builds TypeScript and packs aircall-mcp.mcpb

Install it:

1. Share aircall-mcp.mcpb with your team (Slack, Drive, or this repo's Releases).

2. Double-click it (or Claude Desktop → Settings → Extensions → Advanced settings → Install extension…).

3. Enter your Aircall API ID and API Token — created in the Aircall Dashboard under Integrations & API → API Keys. The token is stored in your OS keychain.

4. Optionally enable Read-only mode to expose only the 36 read tools.

To ship an update: bump the version (see CLAUDE.md), run npm run bundle again, and have users double-click the new file — it updates in place, keeping their saved credentials.

Claude Desktop / Cursor — manual config

{
  "mcpServers": {
    "aircall": {
      "command": "npx",
      "args": ["-y", "@cassiaresearch/aircall-mcp-server"],
      "env": {
        "AIRCALL_API_ID": "your_api_id",
        "AIRCALL_API_TOKEN": "your_api_token"
      }
    }
  }
}

CLI

npx @cassiaresearch/aircall-mcp-server --api-id=xxx --api-token=yyy

# Read-only mode
npx @cassiaresearch/aircall-mcp-server --api-id=xxx --api-token=yyy --read-only

# Only specific categories
npx @cassiaresearch/aircall-mcp-server --api-id=xxx --api-token=yyy --tools=calls,contacts

Related MCP server: boondmanager-mcp-server

Tools (83)

Full per-tool documentation with parameters: docs/tools/README.md (generated from the server itself via npm run docs).

Configuration

Notes:

• Authentication is HTTP Basic with the org-level api_id:api_token pair.

• Requests are rate-limited client-side to respect Aircall's 60 req/min limit.

• Conversation Intelligence tools (transcription, summary, sentiments, topics, action items, CSAT, playbooks, evaluations) require the corresponding Aircall AI add-ons on your account — without them the API returns 403/404.

Development

npm install
npm run build        # compile TypeScript to dist/
npm run lint         # eslint
npm run docs         # regenerate docs/tools/README.md from the built server
npm run bundle       # build + pack aircall-mcp.mcpb (Claude Desktop extension)

License

MIT — see LICENSE.