google-ads-manager-mcp
Provides tools for reading and managing Google Ads accounts, including running GAQL reports, creating and editing campaigns, ad groups, keywords, and responsive search ads, with a draft-to-confirm safety flow for write operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-ads-manager-mcp Show me my campaign performance for the last 30 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Google Ads Manager MCP
Unofficial, community-maintained project. Not affiliated with, endorsed by, or sponsored by Google. "Google Ads" is a trademark of Google LLC.
A local MCP (Model Context Protocol) server that lets an AI assistant read and manage a Google Ads account: run GAQL reports, create campaigns, pause/enable campaigns, and add keywords.
Google also publishes an official Google Ads MCP server, which is read-only (reporting/diagnostics only). This project covers the same reporting ground and adds write support — creating and editing campaigns, budgets, ad groups, keywords, and ads — gated behind a draft/confirm safety layer so nothing changes in your account by accident.
Every write goes through a draft → confirm safety flow: the tool that "creates" or "updates"
something only validates the change against Google's API (validate_only) and hands back a
draftId with a preview. Nothing changes in your Ads account until you call confirm_write with
that draftId. Drafts expire after 10 minutes.
Tools
Read-only:
list_accessible_customers— which accounts this refresh token can reachsearch_gaql— run any raw GAQLSELECTqueryget_campaigns— campaigns with status, budget, and core metricsget_ad_groups— ad groups (optionally filtered to a campaign) with metricsget_keywords— keyword criteria with match type, status, and metricsget_search_terms— actual search terms that triggered your ads, for finding negative keyword candidates
Write (draft → confirm):
create_campaign— new campaign + budget, createdPAUSEDunless you say otherwiseupdate_campaign_status— enable / pause / remove a campaignupdate_campaign_budget— change an existing campaign's daily budgetadd_keywords— add keyword criteria to an ad groupcreate_ad_group— new ad group inside an existing campaignupdate_ad_group_status— enable / pause / remove an ad groupupdate_keyword_status— enable / pause / remove a keyword criterionadd_negative_keywords— add negative keyword criteria to an ad groupcreate_responsive_search_ad— new responsive search ad, createdPAUSEDunless you say otherwiseconfirm_write— execute a previously returneddraftIdfor real
Related MCP server: google-ads-write-mcp
Setup
1. Google Ads developer token
Google Ads → Tools & Settings → API Center. Test-account tokens are issued instantly; a production-level token requires Google's manual review (roughly 1-2 weeks), so apply for that early if you'll use this beyond a test account.
2. OAuth client
Google Cloud Console → APIs & Services → Credentials → Create credentials → OAuth client ID. Choose application type Desktop app. Copy the client ID and client secret.
3. Configure environment
cp .env.example .envFill in GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, and
GOOGLE_ADS_CUSTOMER_ID (the account this server should manage — 10 digits, dashes optional). If
that account is a client under a manager (MCC) account, also set GOOGLE_ADS_LOGIN_CUSTOMER_ID to
the manager account's ID.
4. Get a refresh token
npm install
npm run authThis opens an authorization URL — open it, sign in with the Google account that has access to
your Ads account, approve the adwords scope. The script prints a GOOGLE_ADS_REFRESH_TOKEN;
add it to .env.
5. Build
npm run build6. Point your MCP client at it
For Claude Desktop / Claude Code, add to your MCP config:
{
"mcpServers": {
"google-ads-manager": {
"command": "node",
"args": ["/absolute/path/to/google ads manger mcp/build/index.js"],
"env": {
"GOOGLE_ADS_CLIENT_ID": "...",
"GOOGLE_ADS_CLIENT_SECRET": "...",
"GOOGLE_ADS_DEVELOPER_TOKEN": "...",
"GOOGLE_ADS_REFRESH_TOKEN": "...",
"GOOGLE_ADS_CUSTOMER_ID": "..."
}
}
}
}(Or skip the env block and just make sure .env is populated — the server loads it via
dotenv when run directly, e.g. npm run dev during local iteration.)
Notes
This is scoped to a single Google Ads account (
GOOGLE_ADS_CUSTOMER_ID). To manage several client accounts under one manager account, either run one instance per customer ID, or extendgoogleAdsClient.tsto accept acustomerIdargument per tool call.New campaigns default to
PAUSED(startEnabled: false) so nothing spends until you explicitly enable it.
Contributing
Issues and PRs welcome — new report types, negative-keyword-at-campaign-level support, and multi-account (MCC) handling are the most useful next additions.
License
Available Tools
16 toolsadd_keywordsDraft: add keywords to an ad groupA
Draft adding one or more keyword criteria to an existing ad group. Returns a draftId — call confirm_write to actually apply it.
Inputs: keywords (required), adGroupId (required).
add_negative_keywordsDraft: add negative keywords to an ad groupA
Draft adding one or more negative keyword criteria to an ad group, to stop ads showing for those terms. Returns a draftId — call confirm_write to actually apply it.
Inputs: keywords (required), adGroupId (required).
confirm_writeConfirm a draft writeA
Execute a previously drafted write (from create_campaign, update_campaign_status, or add_keywords) for real. This is the only tool that actually changes the Google Ads account.
Inputs: draftId (required).
create_ad_groupDraft: create an ad groupA
Draft a new ad group inside an existing campaign. Returns a draftId — call confirm_write to actually create it.
Inputs: name (required), campaignId (required), startEnabled.
create_campaignDraft: create a campaign + budgetA
Draft a new campaign with its own daily budget. Creates it PAUSED by default so it never spends until you explicitly enable it. Returns a draftId — call confirm_write to actually create it.
Inputs: name (required), dailyBudgetDollars (required), channelType, startEnabled.
create_responsive_search_adDraft: create a responsive search adA
Draft a new responsive search ad in an ad group, created PAUSED by default. Returns a draftId — call confirm_write to actually create it.
Inputs: adGroupId (required), finalUrls (required), headlines (required), descriptions (required), +1 more.
get_ad_groupsGet ad groups with core metricsA
List ad groups, optionally filtered to one campaign, with status and core performance metrics.
Inputs: limit, status, campaignId.
get_campaignsGet campaigns with core metricsA
List campaigns on the configured customer account with status, budget, and core performance metrics.
Inputs: limit, status.
get_keywordsGet keywords with performanceA
List keyword criteria, optionally filtered to one ad group or campaign, with match type, status, and performance metrics.
Inputs: limit, status, adGroupId, campaignId.
get_search_termsGet search terms reportA
List the actual search terms that triggered your ads, with performance metrics. Useful for finding negative keyword candidates.
Inputs: limit, dateRange, campaignId.
list_accessible_customersList accessible customersA
List the Google Ads customer account resource names reachable with the configured refresh token.
Inputs: no named parameters.
search_gaqlRun a GAQL searchA
Run a raw Google Ads Query Language (GAQL) SELECT query against the configured customer account. Read-only. Use this for custom reports beyond what get_campaigns covers.
Inputs: query (required).
update_ad_group_statusDraft: update ad group statusA
Draft enabling, pausing, or removing an existing ad group. Returns a draftId — call confirm_write to actually apply it.
Inputs: status (required), adGroupId (required).
update_campaign_budgetDraft: update a campaign's daily budgetA
Draft changing the daily budget amount for an existing campaign. Returns a draftId — call confirm_write to actually apply it.
Inputs: campaignId (required), newDailyBudgetDollars (required).
update_campaign_statusDraft: update campaign statusA
Draft enabling, pausing, or removing an existing campaign. Returns a draftId — call confirm_write to actually apply it.
Inputs: status (required), campaignId (required).
update_keyword_statusDraft: update keyword statusA
Draft pausing, enabling, or removing a keyword criterion in an ad group. Returns a draftId — call confirm_write to actually apply it.
Inputs: status (required), adGroupId (required), criterionId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Each tool targets a distinct resource and action: reads (list_accessible_customers, search_gaql, get_campaigns, get_ad_groups, get_keywords, get_search_terms) vs writes (create_campaign, create_ad_group, etc.), with status updates and budget updates cleanly separated. The only potential overlap is search_gaql vs get_* tools, but search_gaql is explicitly for raw GAQL queries beyond the standard retrievers, so ambiguity is minimal.
All tools follow a consistent verb_noun pattern in snake_case (e.g., list_accessible_customers, update_campaign_status, create_responsive_search_ad). Even the special confirm_write uses the same verb-first convention. No mixed styles or unpredictable variations.
16 tools is slightly above the typical 3-15 range but appropriate for a Google Ads manager covering campaigns, ad groups, keywords, ads, search terms, and budgets. The count reflects the breadth of the domain without feeling bloated or redundant.
The surface covers the core lifecycle: listing customers, querying reports, reading and writing campaigns, ad groups, keywords, negative keywords, and responsive search ads, plus status/budget updates and a confirmation mechanism. Minor gaps exist (e.g., editing or removing ads, more ad types), but GAQL search and the existing create/update/remove operations cover most workflows.
Maintenance
Related MCP Connectors
Google Ads MCP server — manage campaigns, keywords, and metrics.
Google Ads MCP: reports, search terms, negatives, budgets, campaigns. Approval on every write.
Hosted Google Ads MCP with OAuth, bounded reads, and prepare/confirm writes.
Google Ads MCP server: run Search, Display, Demand Gen and PMax campaigns from AI.
Related MCP Servers
- AlicenseCqualityBmaintenanceRead-only MCP server for Google Ads, enabling querying campaigns, ad groups, ads, insights, and keywords without create/update/delete operations.17166 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceMCP server that exposes write operations on Google Ads, enabling management of campaigns, ad groups, keywords, RSA ads, sitelinks, images, Customer Match audiences, and recommendations.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for managing Google Ads campaigns through the official Google Ads API, covering accounts, campaigns, budgets, keywords, search terms, and keyword ideas. It provides tools for both reading and mutating live ads data, such as pausing campaigns, updating budgets, and adding keywords.MIT
- FlicenseNot gradedqualityCmaintenanceEnables management of Google Ads accounts via MCP, providing read and write tools for campaigns, ad groups, keywords, assets, and more, with support for reporting and mutations.-