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.
- Site
- ads.google.com
- 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_googleEvery 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/mcpSet it up in your clientBoth 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/listAccountsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ads_google.listAccounts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ads_google.listAccounts())curl -X POST https://api.bowmark.ai/v1/sites/ads_google/listAccounts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required customerIdstringGoogleAdsAccount.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
GoogleAdsCampaignTableinterface 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/listCampaignsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ads_google.listCampaigns({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ads_google.listCampaigns({}))curl -X POST https://api.bowmark.ai/v1/sites/ads_google/listCampaigns \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ads_google.listCampaigns({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/ads_google/<function> - OpenAPI
/v1/sites/ads_google/openapi.json