COCALL. N° 002 / DOCS
INSTALL GUIDE · CLAUDE

CONNECT COCALL
TO CLAUDE.

Cocall gives Claude a real phone number. After a one-time install, Claude can place outbound calls on your behalf — navigating IVRs, holding through queues, asking you mid-call when it genuinely needs a human answer, and handing back a clean transcript.

Pick the Claude surface you use. The install path differs slightly between claude.ai, Claude Desktop, and Claude Code — the underlying MCP endpoint (cocall.ai/mcp) and OAuth flow are identical.

§ 01  /  CLAUDE.AI (WEB)

CLAUDE.AI

  1. 01 Open Settings → Connectors in claude.ai.
  2. 02 Click “Add custom connector”.
  3. 03 Paste the Cocall MCP URL: https://cocall.ai/mcp
  4. 04 Sign in with your Cocall account. Cocall opens an OAuth window and asks Claude for the mcp scope.
  5. 05 Ask Claude to place a call: “Use Cocall to call my dentist and ask if Friday at 3pm is open.”
§ 02  /  CLAUDE DESKTOP

CLAUDE DESKTOP.

  1. 01 Open Claude Desktop → Settings → Connectors.
  2. 02 Click “Add connector” and paste:
  3. https://cocall.ai/mcp
  4. 03 Complete the OAuth flow with your Cocall account. Desktop will reuse the same Cocall login as claude.ai if you’re already signed in.
  5. 04 Cocall’s tools appear in the “Tools” menu of any new conversation.
§ 03  /  CLAUDE CODE (CLI)

CLAUDE CODE.

  1. 01 From any terminal, run:
  2. claude mcp add cocall --transport http https://cocall.ai/mcp
  3. 02 On the next call, Claude Code prompts you to sign in with your Cocall account via your default browser.
  4. 03 Verify with claude mcp list — cocall appears as connected.
§ 04  /  TOOLS

WHAT COCALL DOES INSIDE CLAUDE.

Cocall exposes five MCP tools. Claude picks the right one based on your prompt — you never call them by name.

  • start_call WRITE

    Places an outbound phone call. Blocks until the AI needs an answer or the call ends.

  • resume_call WRITE

    Submits the END USER's answers to mid-call questions, or rejoins a live call after a transport drop.

  • check_call_status READ

    Reads a call's status, listen URL while live, summary and recording when ended.

  • end_call WRITE

    Terminates a live call early.

  • list_recent_calls READ

    Lists the tenant's most recent calls, newest first; active call appears first.

§ 05  /  TROUBLESHOOTING

TROUBLESHOOTING.

OAuth window doesn’t open
Disable popup blockers for claude.ai and cocall.ai, then retry.
Claude says it can’t reach Cocall
Confirm the URL is exactly https://cocall.ai/mcp (no trailing slash, no /v1).
First call fails with “no caller-ID”
Add a verified number at /app/numbers/new before placing your first call.
Need to disconnect
Remove the Cocall connector from Claude’s Connectors settings; Cocall keeps your call history regardless.
§ 06  /  ACCOUNT

NEED A COCALL ACCOUNT?

Sign up for free at cocall.ai/login. First five minutes are on us. After that, $0.12 / minute, billed per call.

GET STARTED BACK TO HOMEPAGE