Google Ads MCP connector

What agents can do

• Report with GAQL: the gaql action runs any Google Ads Query Language query through GoogleAdsService search_stream, which cannot change data. Named templates (campaigns, keywords, geo performance, change history, budgets and more) document the fields agents can select.
• Research keywords and locations: generate_keyword_ideas (Keyword Planner) and suggest_geo_targets.
• Work across manager accounts: get_client_accounts and get_non_manager_accounts list the accounts under an MCC.
• Create campaigns: Search, Display, Performance Max, Dynamic Search Ads and App campaigns, plus ad groups, responsive search and display ads, dynamic search ads and app ads.
• Manage keywords and targeting: add, update and remove keywords and negative keywords; add location, proximity, demographic and audience targeting; set device bid modifiers.
• Assets: sitelinks, callouts, calls, prices, structured snippets, lead forms, images, media bundles, YouTube videos and app deep links.
• Performance Max: create and update asset groups, audience signals, asset links and listing filters.
• Audiences and conversions: create Customer Match lists and upload members; create and update conversion actions and upload click conversions.

Before you connect

• A Google login with access to the Google Ads account. For client accounts you reach through a manager (MCC) account, sign in with a login that can access the manager.
• An InsightfulPipe workspace with a brand for the account. Owners, admins and operators can add connections.

Connect Google Ads

1. In the InsightfulPipe app, open Connectors, choose Google Ads and click Connect.
2. Under Permissions, choose Read Only or Read + Write.
3. Sign in with Google and approve access.
4. Select the accounts to connect. Client accounts under a manager account are included, and each selected account becomes its own connection.
5. Add the MCP server to Claude, ChatGPT or another client, then click Authorize access.

Permissions and safety

• Read Only connections run reports only. Write actions need Read + Write, which grants the adwords scope.
• Campaigns, ad groups and ads created over MCP start PAUSED. Keywords, negative keywords, conversion actions and Performance Max asset groups can be created enabled.
• Updates are live: update_campaign, update_ad_group and update_ad can set status ENABLED (starts spending) or REMOVED (permanent), and resume_ad and resume_ad_group re-enable delivery.
• There is no budget ceiling in the connector. When a campaign uses Target CPA, Target ROAS or Target Impression Share without a value, the connector applies a $10 target CPA, a 3.0 target ROAS or a $10 max CPC.
• Only remove_keywords, remove_negative_keywords and remove_customer_list_members are classified destructive, so they stay off until an owner, admin or operator enables them in Configure actions for this account. Setting REMOVED through an update action is a regular write.
• Every Google Ads read except Keyword Planner runs through gaql, so turning off gaql for an account blocks its reporting.

Limits

• create_campaign does not create Smart, Local, Hotel or Travel campaigns. Use create_performance_max_campaign for Performance Max.
• Video and Demand Gen campaigns can be created, but there are no video or Demand Gen ad creation actions.
• Conversion actions can be hidden but not deleted, and attach_conversion_actions_to_campaign works for App campaigns only.
• GAQL results have no row cap in the connector, so add LIMIT to large queries. timeout_seconds accepts 1 to 120.
• An account added by typing its customer ID is saved without a manager link. Connect client accounts that you only reach through an MCC by signing in and selecting them.

Example prompts

• "Use Google Ads to list my top 10 campaigns by cost last month with conversions and CPA."
• "Which search terms spent more than $50 in the last 30 days without a conversion?"
• "Generate keyword ideas for project management software in the United States."
• "Pause the ad groups in the Spring Sale campaign with a CPA above $80."

Troubleshooting

• "This action is disabled for this connected account." An owner, admin or operator must enable the action in Configure actions for this account.
• "This account is connected read-only, so this action cannot be enabled for it." Reconnect the account with Read + Write.
• A client account is missing: reconnect with a Google login that can reach the manager account, then select the client account.
• Rate limit errors: Google Ads quota errors come back as HTTP 429 with a retry time. Wait, then retry.