CallRail MCP

callrail-mcp

A Model Context Protocol server for the CallRail REST API v3. Point Claude Code, Claude Desktop, Cursor, or any other MCP client at it and ask about your call tracking in plain English.

I'm [Steve Japalucci](https://github.com/pghdma). I run Pittsburgh Digital Marketing Agency (PGHDMA), and I built this for my own client work. CallRail bills per tracking number and per minute across every client I manage, and I was tired of clicking through its reports to answer questions like "which client is burning my minutes this month". Now I ask Claude.

Works with both major versions of the MCP Python SDK (1.x and 2.x).

What I use it for

These are the kinds of questions I ask it every week:

Reporting

• *"Pull last week's calls for Alan Construction, grouped by source"*
• *"Show me every missed call this month"*
• *"Find any calls from 412-555-1234 across all clients in the last 90 days"*
• *"Get the transcript for call CAL019abc..."*

Agency cost attribution

• *"Why is my CallRail bill $174? Break it down by client"*
• *"Which client is the biggest minute user this cycle?"*

Conversion debugging

• *"Why didn't this call convert in Google Ads? CAL019..."*
• *"Is this 58-second call eligible to count as a Google Ads conversion?"*

Lead management

• *"Show me everything this person has ever done: calls, forms, texts"*
• *"Tag this SMS thread as a qualified lead and add a note"*

Tag and tracker management

• *"Tag this call as 'lead' and add a note"*
• *"Provision a new Google Ads call-extension tracker for Renaissance in area code 412"* (requires confirm_billing=True, costs about $3/mo)

Installation

# Recommended: pipx for an isolated CLI install

pipx install callrail-mcp

Or with pip

pip install callrail-mcp

To install from source (latest unreleased):

pipx install git+https://github.com/pghdma/callrail-mcp.git

Auth

Get an API key at Settings > API Keys in your CallRail account. You need Account Admin permission to create one.

Provide it one of two ways:

Option 1: environment variable (recommended for most setups)

export CALLRAIL_API_KEY="your_key_here"

Option 2: key file

mkdir -p ~/.config/callrail

echo "your_key_here" > ~/.config/callrail/api-key.txt chmod 600 ~/.config/callrail/api-key.txt

Or override with CALLRAIL_API_KEY_FILE=/path/to/key.txt.

Optional: pin the account

Every tool resolves the account id with one GET /a.json per process and caches it. Set CALLRAIL_ACCOUNT_ID to skip that lookup, or to pin one account when the key can see several.

Configure your MCP client

Claude Code / Claude Desktop (~/.claude.json or claude_desktop_config.json)

{

"mcpServers": { "callrail": { "command": "callrail-mcp", "env": { "CALLRAIL_API_KEY": "your_key_here" } } } }

If you installed via pipx, callrail-mcp will be on your PATH automatically. Otherwise, point command at the full path to the executable.

Cursor and other clients

The server speaks standard MCP stdio. Any client that supports stdio MCP servers will work; just run callrail-mcp as the command.

Available tools

57 tools total, covering roughly 95% of CallRail's REST API v3 surface: read tools, write tools, tracker provisioning, agency aggregation, account management, notifications, integrations discovery, outbound calls, offline-lead backfill, leads and cross-channel timelines, SMS-thread lead management, and server-side analytics.

Read tools

Write tools

Tracker provisioning

Account management

Notifications and integrations

Outbound calling

Leads and server-side analytics

Agency aggregation

| bulk_update_calls | Apply one update (tag, note, lead_status, spam) to every call matching a filter. `dry_ru