Connect Supermetrics to Claude Code
Query marketing and ads data from 150+ platforms. Google Ads, Meta, GA4, LinkedIn and more, through one API. Add Toolspoke to Claude Code once and it can use 5 Supermetrics actions. Your Supermetrics credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install Supermetrics and connect it
Add Supermetrics to a project in your Toolspoke workspace.
API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- API key
- Supermetrics Hub (hub.supermetrics.com) → your avatar → API keys → Create API key. Only team admins and owners can create one. The key queries every data source login your team has connected.
Choose what Claude Code may do
All 5 actions only read, and any of them can be switched off for a project.
What you can ask Claude Code for
A few of the Supermetrics actions that only read, so they are safe to try first.
- Run one query against a data source and return the rows as JSON
- The dimensions and metrics one data source offers, with the field ids query_data takes
- The status of a query that returned a schedule_id
- Page through the rows of a finished query by schedule_id
What Claude Code can do in Supermetrics
5 actions read.
Reads
Query data
Run one query against a data source and return the rows as JSON. Name the source with ds_id (AW Google Ads, FA Meta Ads, GAWA Google Analytics 4, LIA LinkedIn Ads, …), the accounts with ds_accounts (from list_accounts), and the columns with fields (from list_fields, dimensions first). Check meta.status_code in the answer: SUCCESS means the rows are there; a still-running query returns a schedule_id for get_query_status.
List accounts
The accounts available in one data source through the team's connected logins, the ids query_data takes as ds_accounts.
List fields
The dimensions and metrics one data source offers, with the field ids query_data takes. An install tests itself with it against Google Analytics 4, because it needs the key to be valid and allowed to query but does not depend on which sources the team has connected.
Get query status
The status of a query that returned a schedule_id. SCHEDULED, QUEUED, RUNNING, SUCCESS, FAILURE or STOPPED, with its rows once it has finished. Results expire an hour after the query stops.
Get query results
Page through the rows of a finished query by schedule_id.
Supermetrics in Claude Code: questions
Does Claude Code see my Supermetrics credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Will 5 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Supermetrics action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a Supermetrics call does not run in a sandbox, so it bills nothing.
Supermetrics in your other apps
More analytics toolkits for Claude Code
Try Supermetrics in Claude Code
Free to start, and tool calls cost nothing on any plan.