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.

LiveContext

All integrations

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).

23 toolsOAuthAPI docs

Connect Google Ads How integrations work

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

GETlist_accessible_customers
List 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

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

Change status, 1 operation

POSTget_change_status
Query 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

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

Customer, 1 operation

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

Geo target constant suggestion, 1 operation

POSTget_geo_target_constant_suggestions
Search 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

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

Mutate ad group ad, 1 operation

POSTmutate_ad_group_ads
Create, 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

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

Mutate ad group criteria, 1 operation

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

Mutate bidding strategy, 1 operation

POSTmutate_bidding_strategies
Create, 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

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

Mutate campaign budget, 1 operation

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

Mutate campaign criteria, 1 operation

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

Mutate campaign label, 1 operation

POSTmutate_campaign_labels
Assign or remove labels from campaigns. Enables grouping campaigns by custom categories for filtering and reporting.

Mutate conversion action, 1 operation

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

Mutate customer user access, 1 operation

POSTmutate_customer_user_access
Create, 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

POSTmutate_labels
Create, 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

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

Mutate user list, 1 operation

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

Operation, 1 operation

POSTsearch
Execute 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

POSTsearch_stream
Execute 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

POSTsuggest_keyword_ideas
Generate 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.