AI Google Ads
DocumentationMCP Reference
Setup & connection

gads_get_connection_status

Where the Google Ads setup stands for this workspace: OAuth connection status (connected / error / revoked, which Google account), and how many ad accounts are imported.

Where the Google Ads setup stands for this workspace: OAuth connection status (connected / error / revoked, which Google account), and how many ad accounts are imported. Call this first when setting up or when other tools fail with auth errors.

Scope: read token (or higher). Read-only.

Parameters

ParameterTypeRequiredDescription
projectIdstringNoTarget account (project id). Required with an org-scoped token for account-scoped tools — call gads_list_ad_accounts to enumerate accounts. Omit with a project-scoped token.

gads_get_connect_url

Get the URL that starts the Google Ads OAuth connect flow (consent screen, scope=adwords).

gads_get_sync_status

Sync freshness for the scoped account: last full/incremental sync timestamps and the latest sync run (kind, status, started/finished, error when failed).

On this page

Parameters