briefkin

Advertising · 2 skills

Google Ads MCP and Claude skills

Pull spend, clicks, conversions and search terms from Google Ads with GAQL, and flag campaigns over budget or paying for queries that never convert.

Connect Google Ads to your agent (MCP)

  1. Google Ads MCP server, Google's open-source, read-only server (google-ads-mcp, source). Run it locally with pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp, or deploy it to Cloud Run for remote clients. Its tools are list_accessible_customers, search for GAQL and get_resource_metadata (docs).
  2. Google Ads API with OAuth. Enable the Google Ads API in a Google Cloud project, sign in with Application Default Credentials (gcloud auth application-default login with the adwords scope) or an OAuth client, and set GOOGLE_PROJECT_ID. Add GOOGLE_ADS_LOGIN_CUSTOMER_ID when you reach client accounts through a manager account, and write customer IDs without dashes.

The adwords scope can't be narrowed, so sign in as a Google Ads user with Read only access; the MCP server has no write tools either way.

2 Google Ads skills

Google Ads weekly audit

Every Monday: last week's Google Ads spend and CPA, wasted spend on search terms, disapproved ads and campaigns held back by budget, in one card.

MarketingMondays at 8:30Report cardUses Google Ads.

Morning marketing summary: GA4, Google Ads and Meta Ads

Weekday mornings: yesterday's sessions, key events, ad spend and ROAS across GA4, Google Ads and Meta Ads, against the same day last week.

MarketingWeekdays at 8:00Report cardUses Google Analytics, Google Ads, Meta Ads.

What agents do with Google Ads

Agents read Google Ads with Google Ads Query Language (GAQL) through the API's search and searchStream methods. The resources that matter are campaign, ad_group, keyword_view and search_term_view, with metrics such as metrics.cost_micros, metrics.clicks, metrics.impressions, metrics.conversions, metrics.conversions_value and metrics.cost_per_conversion, plus campaign_budget.amount_micros for budgets. Money comes back in micros, so 12500000 means 12.50 in the account currency.

A typical query is SELECT campaign.name, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_7_DAYS. Marketers turn queries like that into weekly spend and CPA reports, budget pacing checks partway through the month, search term reviews that list wasteful queries to add as negatives, and alerts for campaigns that stopped serving.

ads.google.com

Often used with Google Ads

Teams that use these

Your Google Ads numbers, on one board with everything else

Skills are free to use with any agent. Briefkin is where their results land: one board for every report, number and question your agents send, with a ping when something needs you.

Join the open betaBrowse all skills

Free during the open beta. No card.