Google Ads MCP server for AI agents

Let Claude, ChatGPT or your own agent read Google Ads: 2 typed functions through one MCP server. No Google Ads API key needed.

Functions
2
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Google Ads

An MCP server for Google Ads alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/ads_google
Every site

One MCP server for Google Ads and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 2
  • listAccountsLists every Google Ads account the signed-in caller can open, with its customer id and name, off the account picker.

    Arguments

    None.

    Returns GoogleAdsAccount[]

    interface GoogleAdsAccount {
      customerId: string;          // "123-456-7890", pass this as customerId
      name: string | null;
      ocid: string | null;         // Google Ads' own URL id for the account, when the page showed it
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ads_google/listAccounts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ads_google.listAccounts();
  • listCampaignsReads the Campaigns page grid for one account and date range: each campaign's status, budget, cost, impressions, clicks, CTR, avg.

    Arguments

    NameTypeRequired
    customerIdstring
    GoogleAdsAccount.customerId; omitted = the account Google Ads opens.
    No
    dateRange"today" | "yesterday" | "last_7_days" | "last_14_days" | "last_30_days" | "this_month" | "last_month" | "all_time"
    Default "last_30_days".
    No

    Returns GoogleAdsCampaignTable

    interface GoogleAdsStats {
      cost: number | null;         // in the account's currency
      impressions: number | null;
      clicks: number | null;
      ctr: number | null;          // percent
      avgCpc: number | null;
      conversions: number | null;
      costPerConversion: number | null;
    }
    
    interface GoogleAdsCampaign {
      name: string; status: string | null; budget: string | null; campaignType: string | null;
      stats: GoogleAdsStats;
    }
    
    interface GoogleAdsCampaignTable {
      campaigns: GoogleAdsCampaign[];
      total: GoogleAdsStats | null;  // the grid's own "Total" row
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ads_google/listCampaigns

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ads_google.listCampaigns({});

Use it from code