How do I connect Callmine to Claude, ChatGPT, or other AI clients?
Updated Jun 1, 2026
Connect Callmine to Claude Desktop, claude.ai, or ChatGPT in a few clicks. 19 tools, OAuth 2.1 sign-in, scoped to one workspace.
TL;DR
Callmine exposes an MCP server at mcp.callmine.ai with 19 tools
covering reports, schedules, audits, and analysis runs. Add it as a
connector in Claude Desktop, claude.ai, or ChatGPT; complete the
OAuth flow once; ask the AI to do work in your Callmine workspace.
How it works
MCP (Model Context Protocol) is the open standard for connecting AI
clients to external tools. Callmine ships a compliant MCP server that
runs over HTTPS at mcp.callmine.ai.
When you add Callmine as a connector:
- 01The AI client redirects you to Callmine's OAuth flow.
- 02You sign in with Clerk (same login as the web app).
- 03You authorize the AI client to act on a specific workspace.
- 04The MCP server issues a scoped access token bound to your identity and that workspace.
From then on, the AI client can call any of the 19 tools on your behalf. Tokens refresh transparently — once set up, you don't see the auth flow again until you explicitly revoke.
The 19 tools
The tool catalog covers four areas:
- ·Identity and configuration — read your workspace profile, prompt library, audit log, and cost history.
- ·Reports — list, search, and read past reports.
- ·Analyses — preview filters, start new runs, check job status, cancel running jobs.
- ·Schedules — list, inspect, create, activate, pause, resume, and delete schedules.
Read-only tools fire immediately. Mutating tools (start analysis,
create schedule, delete schedule) write to your workspace audit log
with source: mcp so the action is traceable.
The preview-then-start guard
Starting an analysis is the only tool with a two-step handshake. The
AI client must first call callmine_preview_analysis to get a
short-lived confirmation token, then call callmine_start_analysis
with that token. This prevents a single misinterpreted prompt from
burning quota.
The confirmation token is single-use, expires in 5 minutes, and is bound to the exact configuration that was previewed. Changing the config requires a fresh preview.
Adding Callmine as a connector
The connector URL is the same for every client:
https://mcp.callmine.ai/mcpThe OAuth flow is identical regardless of client — paste the URL, sign in with your Callmine credentials, approve the scopes, done. The differences below are just where each app puts the "add connector" button.
Claude Desktop
- 01Open Settings → Connectors → Add custom connector.
- 02Name it
Callmineand pastehttps://mcp.callmine.ai/mcpas the server URL. - 03Save. Claude Desktop opens a browser tab to Callmine's sign-in.
- 04Sign in with your normal Callmine account and click Approve on the consent screen.
- 05Back in Claude Desktop, ask "What Callmine plan am I on?" to confirm the connection.
claude.ai
- 01Go to Settings → Connectors → Add custom connector.
- 02Paste
https://mcp.callmine.ai/mcpas the server URL and give it a name (e.g.Callmine). - 03Click Connect — claude.ai opens the Callmine sign-in flow in a new tab.
- 04Sign in and approve the scopes.
- 05The connector appears in your connector list as connected. Start a new chat and Callmine tools are available.
ChatGPT
- 01In ChatGPT, open Settings → Connectors → Add custom connector (available on Plus, Pro, Team, and Enterprise plans).
- 02Paste
https://mcp.callmine.ai/mcpand pick a display name. - 03ChatGPT opens the Callmine sign-in flow.
- 04Sign in, approve the scopes, return to ChatGPT.
- 05Toggle the Callmine connector on for the conversation, then ask it to do something — e.g. "List my last five Callmine reports."
After connecting
The first call to any tool consumes the access token; from then on the AI client refreshes silently. You'll only see the auth flow again if you revoke the connection (or if you reconnect from a new device).
Every mutating tool call — starting an analysis, creating a
schedule, deleting a schedule — writes to /audit with
source: mcp, so workspace admins can always see what the AI did.
Disconnecting
To revoke a connector, remove it from the AI client's connector
settings. The MCP-side token is invalidated on the next call.
Workspace admins can also revoke all MCP grants for the workspace
by emailing hello@callmine.ai.
Troubleshooting
- ·Sign-in loop or "session invalid" after authenticating. Clear
cookies for
callmine.aiand try again, or sign in toapp.callmine.aifirst in the same browser, then re-run the connector setup. - ·"Confirmation required" when asking the AI to run an analysis. Expected. The AI must preview before starting — ask it to "preview the analysis first, then start it" and it will chain the two tools.
- ·The AI says it doesn't see Callmine tools. Make sure the Callmine connector is enabled for the current chat in your AI client's chat-level connector toggles. Setting up the connector at the workspace level doesn't always enable it per chat.
For anything else, email hello@callmine.ai with the AI client
name and the exact error message you saw.