← all repositories
cohnen/mcp-google-ads

Chat with your ad spend

This MCP server lets AI assistants query and visualize Google Ads campaigns in plain English instead of forcing you to write GAQL.

669 stars Python Coding AssistantsOther AI
mcp-google-ads
Not currently ranked — collecting fresh signals.
star history

What it does

This is an MCP (Model Context Protocol) server that bridges Google Ads and AI assistants such as Claude, Cursor, or Windsurf. It exposes account lists, campaign metrics, keyword performance, and ad analytics as callable tools, so the AI can fetch live data during a conversation. You ask questions in plain English; the assistant handles the GAQL queries and can even render charts from the results.

The interesting bit

The project is largely a protocol adapter—FastMCP wrapping the Google Ads API with a bit of formatting sugar—so most of the heavy lifting is still GAQL under the hood. The practical twist is that it returns structured data in a way Claude can turn into charts and comparative analyses on the fly, and the run_gaql tool gives analysts an escape hatch when chat is too fuzzy. It’s glue code, but glue that speaks both marketing and engineering.

Key highlights

  • Five built-in tools covering account listing, campaign performance, ad performance, and two GAQL query runners
  • Supports both OAuth 2.0 and service-account authentication against the Google Ads API
  • run_gaql returns data in table, JSON, or CSV format for flexible consumption
  • Lets Claude generate charts and graphs from the advertising data during conversation
  • Compatible with any MCP client, including Claude Desktop, Cursor, and Windsurf

Caveats

  • New Google Ads API users receive a restricted test Developer Token that carries limitations until production approval (typically 1–3 business days)

Verdict

Best for advertising managers and marketers who already live inside AI chat clients and want ad-hoc campaign insights without learning Google Ads Query Language. If you don’t run Google Ads or already have a polished BI pipeline, this is just another API wrapper to ignore.

Frequently asked

What is cohnen/mcp-google-ads?
This MCP server lets AI assistants query and visualize Google Ads campaigns in plain English instead of forcing you to write GAQL.
Is mcp-google-ads open source?
Yes — cohnen/mcp-google-ads is open source, released under the MIT license.
What language is mcp-google-ads written in?
cohnen/mcp-google-ads is primarily written in Python.
How popular is mcp-google-ads?
cohnen/mcp-google-ads has 669 stars on GitHub.
Where can I find mcp-google-ads?
cohnen/mcp-google-ads is on GitHub at https://github.com/cohnen/mcp-google-ads.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.