Research & Benchmarks Optimization AI Ads Analytics Why Madgicx? About Us Blog Careers Case Studies Events Glossary Guides Answers Pricing Login Try for Free
MCP docs menu

Google Ads MCP Ad Account Tools

List Google Ads customers (ad accounts) accessible to the team.

Tools for discovering Google Ads customer accounts accessible to the authenticated team.

Start Here

Call list_ad_accounts first to discover available customer IDs. The returned IDs are required by every other tool (list_campaigns, list_ad_groups, list_ads, get_insights).

list_ad_accounts

List Google Ads customers accessible to the authenticated team. Returns each customer's ID, resource name, descriptive name, currency, time zone, manager / test flags, and status.

When include_details is true (default), the tool issues a per-customer GAQL query to enrich the response with descriptive name, currency, time zone, manager, test, and status. Set it to false for a faster ID-only response.

Parameters

Parameter Type Description
include_details boolean When true (default), enrich each accessible customer with descriptive_name, currency_code, time_zone, manager, test_account, and status. When false, only IDs and resource names are returned.
login_customer_id string | undefined Optional manager (MCC) customer ID for the login-customer-id header. Required when discovering accounts via an MCC. Accepts dashed (123-456-7890) or digits-only (1234567890) format.

Example

Natural Language

What Google Ads accounts do I have access to?
List my Google Ads customers

Direct Query

{
  "tool": "list_ad_accounts",
  "arguments": {
    "include_details": true
  }
}

Response

Returns a list of customer accounts. Each entry includes the 10-digit customer ID, resource name, and (when include_details=true) descriptive name, currency, time zone, manager flag, test-account flag, and status.

Official Meta Business Partner

Connect your AI assistant to your ad accounts. The 7-day free trial includes both MCPs.

Sign in with your Madgicx login, add the server addresses and ask in plain words. Meta changes wait for your confirmation, and the Google Ads MCP only reads.

Try for Free ($0 Trial)
200,000+ advertisers
$10B+ annual ad spend visibility
4.6 / 5 on G2, from 220+ reviews