Can I use Google Ads as a CLI?

Yes. KosmoKrator exposes a Google Ads CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Google Ads through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Google Ads tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Google Ads credentials stored?

Google Ads credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Google Ads MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

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.

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.

Agent Surfaces

Google Ads CLIHeadless setup, JSON output, direct function calls. Google Ads MCPExpose selected tools to local MCP clients. Google Ads LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: google-ads
route_slug: google-ads
package: google-ads
auth_strategy: oauth2_with_developer_token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Runtime Requirements

Name	Type	Description
`runtime`	dependency
`runtime`	dependency
`runtime`	dependency

Function Catalog

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