List Google Ads accounts (`adsap_google_list_ad_accounts`)

Platform: Google Ads · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No

What it does

Lists the Google Ads accounts connected in your workspace. Each row carries the 10-digit customer ID, the account name, currency, time zone and status. The copilot uses this list to pick the account before any other Google Ads call.

When to use it

Use it first. Its id is the ad_account_id that the other Google Ads tools need.
It reads Adsap’s own records and never calls the Google Ads API.
It lists only the accounts connected in this workspace that you can reach. Other accounts are left out without an error.
It takes no required arguments. limit goes up to 100 and cursor fetches the next page.
For Meta ad accounts, use adsap_list_ad_accounts.

Worked example

You ask

“Which Google Ads accounts are connected to my workspace?”

The assistant calls `adsap_google_list_ad_accounts`

{}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


{
  "ok": true,
  "data": [
    {
      "id": "1234567890",
      "name": "Example Store",
      "display_name": "Example Store (1234567890)",
      "platform": "google",
      "currency": "USD",
      "timezone": "America/New_York",
      "status": "ACTIVE",
      "google_status": "ENABLED",
      "is_manager": false,
      "is_test": false,
      "synced_at": "2026-09-18T08:05:00+00:00"
    }
  ],
  "meta": {
    "is_stale": false,
    "last_refreshed_at": "2026-09-18T08:05:00+00:00",
    "next_cursor": null,
    "total_count": 1,
    "ad_account_id": null
  }
}

How to read it

id is the bare 10-digit customer ID, with no dashes. status uses Adsap’s wording and google_status keeps Google’s own, so ACTIVE and ENABLED mean the same thing here. synced_at is when Adsap last synced the account details from Google. is_test marks a Google Ads test account.

With one account, the assistant can move on to adsap_google_list_campaigns or adsap_google_get_insights. With several, it asks you which one to use. When data is empty, the response carries a human_readable_summary that says no Google Ads account is connected or reachable.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`limit`	number	No
`cursor`	string	No

Example prompts

“Which Google Ads accounts do I have connected?”
“Show me all my ad accounts on both Meta and Google.”
“What currency is my Google Ads account in?”

Notes

When your question does not name a platform, the copilot lists Meta and Google accounts together. Google customer IDs are bare 10-digit numbers, with no dashes.

Guide

Read Google Ads for the workflow around this tool, and the Tool reference for every tool.

The Google Ads MCP server page shows how to connect Google Ads to Claude, ChatGPT or Perplexity.

List Google Ads accounts (adsap_google_list_ad_accounts)