To run a GAQL query in Google Ads with Claude or ChatGPT, connect your Google Ads account to PaidSync.ai and ask the assistant to run a GAQL query, which reads almost any resource in the account. GAQL is Google's query language. The tool is read-only, so a query cannot change anything.
GAQL is the query language behind Google Ads reports. When no ready-made report fits, Claude can write the query and run it:
run_gaql_query executes any GAQL query and is read-only. It can query campaigns, ad groups, ads, keywords, assets, audiences, bidding strategies, experiments, invoices and change events, among 100 or more resources.list_accounts lists the Google Ads accounts you can query.run_gaql_query and list_accounts only read your account.
| Tool | What it does |
|---|---|
| run_gaql_query | Runs the query you describe |
| list_accounts | Shows which accounts you can run it on |
A query uses SELECT, FROM, WHERE, ORDER BY and LIMIT, for example SELECT campaign.id, campaign.name FROM campaign. You do not have to write it yourself. Describe the table you want, and have the assistant show the query it ran so you can reuse it.
These steps use Claude to run a GAQL query. PaidSync.ai also works in ChatGPT, and the prompts are the same.
Start at paidsync.ai, then link Google Ads through Google's own sign-in screen. No developer token and no Google Cloud project are involved. The login you choose must reach the account where you will run a GAQL query.
Open Claude's connector directory, add PaidSync.ai and sign in. Ask "list my Google Ads accounts", then pick the account where you will run a GAQL query.
Say what you want in plain words, such as paused campaigns with their budgets, or the top search terms by clicks.
Ask the assistant to show the GAQL it wrote before running it, so you can check the fields and filters.
Run it, then refine the query with a date filter or a limit until the table is what you need.
Compare a total from the query with the same total in Google Ads for one campaign. If they match, you can trust the rest of the table.
Use these two prompts to run a GAQL query, in this order.
run_gaql_query and list_accounts only read the account, so nothing here edits a campaign.run_gaql_query and list_accounts work with a key that cannot change anything. Tokens are encrypted at rest.Every Google Ads tool PaidSync.ai offers is on the Google Ads MCP server page, including the tools used to run a GAQL query.
In Google Ads, open the query builder or the API and write a GAQL statement. With PaidSync.ai, ask Claude or ChatGPT in plain English, and it writes and runs the query for you.
No. run_gaql_query is read-only. Changes go through the write tools, which preview first.
Yes. PaidSync.ai connects Google Ads to ChatGPT and to Claude, and the same tools run in both, so you can ask it to run a GAQL query the same way you would in Claude.
A connected Google Ads account. The query is written for you from your description.
PaidSync.ai is free for 15 tasks a month with no card, enough to run a GAQL query and see the result. Pro starts at $99 a month. See pricing.
PaidSync.ai runs 630+ tools across 14 ad and analytics platforms. Connect your accounts once and use them in the AI assistant you already work in.
Get Started Free Book a Demo