Integration

Google Ads integration

Online advertising platform by Google. Create and manage search, display, video, and shopping ad campaigns. Target audiences by keywords, demographics, interests, and remarketing lists. Track conversions, optimize bids, and analyze performance metrics across campaigns, ad groups, and individual ads using Google Ads Query Language (GAQL).

Connect Google Ads How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Google Ads.Built from the 23 Google Ads tools below, on the connection you add once.

Common Google Ads use cases

get customer programmatically
search stream programmatically
search operation programmatically
get change status programmatically
get campaign budget programmatically
execute mutate label programmatically
execute mutate ad group programmatically
execute mutate campaign programmatically
upload click conversion programmatically
execute mutate user list programmatically

What you can do with Google Ads

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Accessible customer, 1 operation

list_accessible_customersList accessible customersGETList all customer accounts (CIDs) accessible by the authenticated user. Returns resource names for each accessible customer. Does not require a customer ID in the path.

Campaign budget, 1 operation

get_campaign_budgetGet campaign budgetPOSTRetrieve a specific campaign budget by resource name. Returns budget amount, delivery method, and associated campaigns.

Change status, 1 operation

get_change_statusGet change statusPOSTQuery recent changes made to the Google Ads account using GAQL. Returns a log of modifications to campaigns, ad groups, ads, and other resources with timestamps and change types.

Click conversion, 1 operation

upload_click_conversionsUpload click conversionsPOSTUpload offline click conversions to attribute conversions back to Google Ads clicks using gclid (Google Click ID).

Customer, 1 operation

get_customerGet customerPOSTRetrieve details for a specific Google Ads customer account including descriptive name, currency code, time zone, and account status

Geo target constant suggestion, 1 operation

get_geo_target_constant_suggestionsGet geo target constant suggestionsPOSTSearch for geo target constants (locations) by name or resource name. Used to find location IDs for geographic targeting in campaigns.

Mutate ad group, 1 operation

mutate_ad_groupsMutate ad groupsPOSTCreate, update, or remove ad groups within a campaign. Ad groups contain ads and targeting criteria (keywords, audiences).

Mutate ad group ad, 1 operation

mutate_ad_group_adsMutate ad group adsPOSTCreate, update, or remove ads within an ad group. Supports responsive search ads, responsive display ads, and other ad formats.

Mutate ad group asset, 1 operation

mutate_ad_group_assetsMutate ad group assetsPOSTCreate, update, or remove ad group assets (sitelinks, callouts, structured snippets, call assets) at the ad group level.

Mutate ad group criteria, 1 operation

mutate_ad_group_criteriaMutate ad group criteriaPOSTCreate, update, or remove ad group criteria (keywords, audiences, placements, topics). Keywords use match types: EXACT, PHRASE, or BROAD.

Mutate bidding strategy, 1 operation

mutate_bidding_strategiesMutate bidding strategiesPOSTCreate, update, or remove portfolio bidding strategies. Portfolio strategies can be shared across multiple campaigns. Supports Target CPA, Target ROAS, Maximize Conversions, and other automated strategies.

Mutate campaign, 1 operation

mutate_campaignsMutate campaignsPOSTCreate, update, or remove campaigns. Supports multiple operations in a single request with optional partial failure handling.

Mutate campaign budget, 1 operation

mutate_campaign_budgetsMutate campaign budgetsPOSTCreate, update, or remove campaign budgets. Budgets are shared resources that can be assigned to one or more campaigns.

Mutate campaign criteria, 1 operation

mutate_campaign_criteriaMutate campaign criteriaPOSTCreate, update, or remove campaign-level targeting criteria including locations, languages, and negative keywords for campaign-wide exclusions.

Mutate campaign label, 1 operation

mutate_campaign_labelsMutate campaign labelsPOSTAssign or remove labels from campaigns. Enables grouping campaigns by custom categories for filtering and reporting.

Mutate conversion action, 1 operation

mutate_conversion_actionsMutate conversion actionsPOSTCreate, update, or remove conversion actions. Conversion actions track valuable customer actions like purchases, sign-ups, or phone calls.

Mutate customer user access, 1 operation

mutate_customer_user_accessMutate customer user accessPOSTCreate, update, or remove user access to a Google Ads customer account. Manage who can access the account and their permission level (ADMIN, STANDARD, READ_ONLY, EMAIL_ONLY).

Mutate label, 1 operation

mutate_labelsMutate labelsPOSTCreate, update, or remove labels. Labels are used to organize campaigns, ad groups, ads, and keywords into custom categories for reporting and management.

Mutate remarketing action, 1 operation

mutate_remarketing_actionsMutate remarketing actionsPOSTCreate, update, or remove remarketing actions for building audience lists based on user interactions with your website or app.

Mutate user list, 1 operation

mutate_user_listsMutate user listsPOSTCreate, update, or remove user lists (audiences) for targeting. Supports CRM-based, rule-based, and similar audience lists.

Operation, 1 operation

searchSearchPOSTExecute a Google Ads Query Language (GAQL) query with pagination support. Returns results in pages using pageToken. Preferred for smaller result sets or when page-level control is needed.

Stream, 1 operation

search_streamSearch streamPOSTExecute a Google Ads Query Language (GAQL) query and return all results in a single streamed response. Use for large result sets. Supports querying campaigns, ad groups, ads, keywords, metrics, and all other Google Ads resources.

Suggest keyword idea, 1 operation

suggest_keyword_ideasSuggest keyword ideasPOSTGenerate keyword ideas based on seed keywords, a URL, or both. Returns search volume, competition, and bid estimates for each keyword suggestion.

OAuth scopes Google Ads requires

Each operation declares the scopes Google Ads requires for it.

https://www.googleapis.com/auth/adwordsneeded by get_campaign_budget, get_change_status, get_customer and 20 more

Google Ads API rate limits

100 requests per second

Access level dependent. Basic: 15K ops/day, Standard: 150K ops/day. See https://developers.google.com/google-ads/api/docs/best-practices/rate-limits

These are the limits Google Ads documents, not ones LiveContext measured. They can change and often depend on your plan, so check the Google Ads documentation for current values.

Use Google Ads from Claude Code, Cursor or Codex

Connect Google Ads in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Google Ads operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Google Ads

Create your workspace
Sign up free. Nothing to install.
Connect Google Ads once
Add your Google Ads connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Google Ads integration FAQ

What can you do with the Google Ads integration?

LiveContext exposes 23 operations on Google Ads, covering accessible customer, campaign budget, change status and click conversion. Common uses include get customer programmatically, search stream programmatically and search operation programmatically.

Which OAuth scopes does Google Ads require?

The operations that declare a scope all need https://www.googleapis.com/auth/adwords.

What are the Google Ads API rate limits?

Google Ads documents 100 requests per second. Access level dependent. Basic: 15K ops/day, Standard: 150K ops/day. See https://developers.google.com/google-ads/api/docs/best-practices/rate-limits Limits are set by Google Ads and can depend on your plan.