Skip to content

Supafone + Claude & Codex

Give Claude and Codex a phone.

Connect Supafone once and your agent can search every call you have had, read the transcripts and notes, work through your open follow-ups, and have your Supafone AI place a real call after you say yes. Setup takes about two minutes.

You need the Supafone iPhone app and Claude Desktop, Claude Code, Codex or another MCP client.

Example in Claude Desktop, ask about a call:

You: What did Dana promise on Tuesday’s call?

Uses the Supafone tool search_calls (query: "what Dana promised, Tuesday"): 3 matching passages.

Uses the Supafone tool get_call (call_id: "c_7f3a"): Northline pricing call · Tue 2:14 pm · notes, transcript.

Claude Desktop: On Tuesday’s Northline pricing call, Dana promised to send the signed order form by Friday and to bring her ops lead to a demo. You promised to hold the launch discount through November.

Example in Codex CLI, place a call:

You: Call Northline and confirm Thursday at 2.

Uses the Supafone tool get_contact_history (name: "Northline"): Dana Whitaker · +1 415 555 0134 · 4 calls.

Codex CLI: This places a real call from your number to Dana at Northline, +1 415 555 0134, to confirm Thursday at 2 pm. Go ahead?

You: Yes, call.

Uses the Supafone tool start_ai_call (confirm: true · objective: "Confirm Thursday at 2 pm"): placed · call is starting.

Supafone calls Northline · Dana Whitaker. Dana says: Thursday at 2 works. See you then. The call ends, confirmed.

Uses the Supafone tool get_call (call_id: "c_91bd"): completed · notes ready.

Codex CLI: Confirmed. Dana will see you Thursday at 2 pm and asked you to bring the Pro quote. It’s in your Supafone notes.

Works with

  • Claude DesktopOne block in your configWorks today
  • Claude CodeOne command in your terminalWorks today
  • CodexCLI and IDE extensionWorks today
  • Any MCP clientOver HTTP or mcp-remoteWorks today
  • Claude.ai and the Claude appA custom connector, no keyWorks today
  1. Create your key in the app

    In Supafone, open Settings, then Use with Claude & Codex, and copy your key. It starts with sfp_. Everyone gets one automatically. The key only sees your own calls, and you can revoke it there anytime.

  2. Add Supafone to Claude or Codex

    Claude Code: run this once in your terminal, with your key.

    Terminal
    claude mcp add --transport http supafone https://api.supafone.ai/mcp \
      --header "Authorization: Bearer sfp_YOUR_KEY"

    Claude Desktop: open Settings, then Developer, then Edit Config. Add the block below to claude_desktop_config.json with your key, then quit and reopen Claude Desktop. It needs Node.js for npx.

    claude_desktop_config.json
    {
      "mcpServers": {
        "supafone": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://api.supafone.ai/mcp",
                   "--header", "Authorization:${SUPAFONE_AUTH}"],
          "env": { "SUPAFONE_AUTH": "Bearer sfp_YOUR_KEY" }
        }
      }
    }

    Codex (OpenAI): add this to ~/.codex/config.toml with your key, then restart Codex. It works in the Codex CLI and the IDE extension.

    ~/.codex/config.toml
    [mcp_servers.supafone]
    command = "npx"
    args = ["-y", "mcp-remote", "https://api.supafone.ai/mcp", "--header", "Authorization:${SUPAFONE_AUTH}"]
    env = { SUPAFONE_AUTH = "Bearer sfp_YOUR_KEY" }

    Any other MCP client: point it at https://api.supafone.ai/mcp with the same Authorization: Bearer header, directly or through mcp-remote.

    Claude.ai and the Claude app: no key needed. On claude.ai or in Claude Desktop, open Settings > Connectors, choose Add custom connector, name it Supafone and paste https://api.supafone.ai/mcp. Click Connect, sign in with your Supafone email and password, then click Allow. It works in the Claude phone app too.

  3. Ask Claude or Codex

    Start a new chat. Supafone appears in Claude’s list of connected tools. Try one of the prompts below.

Seven tools, one key

Everything your agent can do with Supafone. Six only read your calls; start_ai_call places a real call and only runs after you confirm the number and the goal.

  • search_callsSearch every call and your saved info by meaning.
  • get_callOne call in full: transcript, notes, key facts, promises.
  • list_callsRecent calls: who, when, how long, a short summary.
  • list_follow_upsOpen follow-ups and commitments across your calls.
  • get_contact_historyEvery call with one person or business.
  • get_coach_settingsYour live coach, its goal and your saved objectives.
  • start_ai_callHave your Supafone AI place a real call, after you say yes.

Things to ask

  • “What did Acme push back on in my calls last week?”Searches your call notes and transcripts by meaning, not just keywords.
  • “List my open follow-ups and draft the emails.”Reads the follow-ups Supafone pulled from each call.
  • “Summarize every call I have had with Dana.”Pulls the full history for a person or number.
  • “Have Supafone call +1 203 555 0142 and book a cleaning for next week.”Claude asks you to confirm before any real call is placed.

Built to be safe

Claude has to confirm before it places a real call, and calls go through the same number checks and rate limits as the Supafone app. Your key only reads your own calls, stays in your Claude config rather than the chat, and can be revoked in the app anytime.

Calls Claude starts are placed by your Supafone AI with your verified caller ID, the same as AI calls for me in the app. Prefer to build your own voice agents? See Supafone for business. Need help? Email feedback@supafone.ai.

Get Supafone on your iPhone

Live captions and a coach on every call, notes when you hang up, and an AI that makes calls for you.