KosmoKrator

analytics

Google Ads MCP, CLI, and Lua Integration for AI Agents

Google Ads integration docs for AI agents: MCP gateway setup, Google Ads CLI commands, Lua API reference, credentials, and function schemas.

38 functions 18 read 20 write oauth2 with developer token auth
Submit Google Ads feedback View package source

Google Ads for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata
integration_slug
google_ads
route_slug
google-ads
package
google-ads
auth_strategy
oauth2_with_developer_token oauth2 with developer token
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true
supports_multi_account
true

Quick Links

Lua APIAgent-facing namespace and function reference. Google Ads CLIHeadless setup and direct function calls. Google Ads MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Google Ads MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Google Ads.

Claude Code Google Ads MCP setup for Claude Code. Cursor Google Ads MCP setup for Cursor. Codex Google Ads MCP setup for Codex. OpenAI Agents Google Ads MCP setup for OpenAI Agents SDK. Claude Agent SDK Google Ads MCP setup for Claude Agent SDK. Vercel AI SDK Google Ads MCP setup for Vercel AI SDK. LangChain Google Ads MCP setup for LangChain. LangGraph Google Ads MCP setup for LangGraph. CrewAI Google Ads MCP setup for CrewAI. MCP clients Google Ads MCP setup for Generic MCP Clients.

Google Ads CLI Matrix

Use these pages for direct Google Ads CLI workflows in scripts, CI, cron, and agent wrappers.

CI Google Ads CLI for CI. Cron Jobs Google Ads CLI for cron jobs. Shell Scripts Google Ads CLI for shell scripts. Headless Automation Google Ads CLI for headless automation. Coding Agents Google Ads CLI for coding agents.

Runtime Requirements

NameTypeDescription
runtime dependency
runtime dependency
runtime dependency

Function Catalog

FunctionTypeParametersDescription
google_ads.google_ads_diagnostics Read read 0 Show safe configuration diagnostics.
google_ads.google_ads_list_accessible_customers Read read 0 List Google Ads customers directly accessible to the OAuth user.
google_ads.google_ads_list_customer_clients Read read 0 List managed client accounts under a manager or customer.
google_ads.google_ads_search Read read 0 Run a paginated Google Ads Query Language search.
google_ads.google_ads_search_stream Read read 0 Run a streaming GAQL report for larger result sets.
google_ads.google_ads_campaign_report Read read 0 Run a normalized campaign performance report.
google_ads.google_ads_ad_group_report Read read 0 Run a normalized ad group performance report.
google_ads.google_ads_ad_report Read read 0 Run an ad and creative performance report.
google_ads.google_ads_keyword_report Read read 0 Run a keyword performance report.
google_ads.google_ads_search_term_report Read read 0 Analyze search terms and query performance.
google_ads.google_ads_asset_report Read read 0 Report on assets and policy/performance labels.
google_ads.google_ads_performance_max_report Read read 0 Report on Performance Max campaigns and asset groups.
google_ads.google_ads_list_campaigns Read read 0 List campaigns with status, budget, channel, and optimization fields.
google_ads.google_ads_create_campaign_budget Write write 0 Create a campaign budget with micros normalization.
google_ads.google_ads_manage_campaign Write write 0 Create, update, pause, enable, or remove campaigns.
google_ads.google_ads_manage_ad_group Write write 0 Create, update, pause, enable, or remove ad groups.
google_ads.google_ads_manage_keyword Write write 0 Add, update, or remove keyword criteria.
google_ads.google_ads_manage_ad Write write 0 Create or manage responsive search ads and ad statuses.
google_ads.google_ads_manage_campaign_criteria Write write 0 Add or remove location, language, schedule, and negative criteria.
google_ads.google_ads_upload_image_asset Write write 0 Create image assets from pre-encoded image metadata.
google_ads.google_ads_link_asset Write write 0 Link an asset to a customer, campaign, ad group, or asset group.
google_ads.google_ads_create_search_campaign Write write 0 Create a complete paused Search campaign with budget, ad group, keywords, targets, and RSA.
google_ads.google_ads_create_performance_max_campaign Write write 0 Create a governed Performance Max campaign using mixed mutate operations.
google_ads.google_ads_generate_keyword_ideas Read read 0 Generate keyword ideas and forecasts inputs.
google_ads.google_ads_list_recommendations Read read 0 List optimization recommendations.
google_ads.google_ads_apply_recommendations Write write 0 Apply selected recommendations with explicit confirmation.
google_ads.google_ads_upload_click_conversions Write write 0 Upload offline or enhanced lead click conversions.
google_ads.google_ads_upload_call_conversions Write write 0 Upload offline call conversions.
google_ads.google_ads_create_customer_match_list Write write 0 Create a CRM-based user list for Customer Match.
google_ads.google_ads_run_customer_match_job Write write 0 Create, populate, and run an OfflineUserDataJob for audience uploads.
google_ads.google_ads_get_change_status Read read 0 List changed resources for sync workflows.
google_ads.google_ads_get_change_events Read read 0 List field-level recent account changes.
google_ads.google_ads_create_batch_job Write write 0 Create a batch job for large async operations.
google_ads.google_ads_mutate Write write 0 Governed resource-specific or mixed mutate escape hatch.
google_ads.google_ads_raw_request Write write 0 Low-level versioned Google Ads API request for advanced coverage.
google_ads.google_ads_list_billing_setups Read read 0 List billing setup resources.
google_ads.google_ads_account_budget_proposal Write write 0 Create account budget proposal operations for monthly invoicing accounts.
google_ads.google_ads_invite_user Write write 0 Invite a user to a Google Ads account.