# Google Ads MCP

> Google Ads MCP is an open-source MCP server for marketing and seo. Google Ads reports, GAQL queries and confirmed campaign changes from your agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** vscode, CLI
- **Website:** https://renzojohnson.com/contributions/google-ads-mcp
- **MCP Registry name:** com.renzojohnson/google-ads-mcp
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-15

## About

Fourteen tools split ten reads from four admin tools. Reads cover accounts, campaigns, ad groups, ads, keywords, search terms and performance totals, and ads_query runs any read-only Google Ads Query Language SELECT for cuts such as clicks by device or conversions by location. Admin tools create and manage search campaigns, ad groups, responsive search ads and keywords.

Because every admin action can spend money, each one needs confirm: true, and new campaigns, ad groups and ads are created paused. It does not create Performance Max, Shopping, Display or video campaigns, and creating a campaign requires an EU political advertising declaration. Amounts are in micros, which the agent converts.

It is an independent local extension and npm package, not Google's official server. You need your own developer token with approved access, OAuth credentials and a customer ID; a manager account works.

## Features

- **Read tools:** Accounts, campaigns, ad groups, ads, keywords and search terms.
- **GAQL queries:** Run any read-only query for custom breakdowns.
- **Performance totals:** Account totals, or by campaign, for a date range.
- **Campaign admin:** Create search campaigns, pause, enable, remove and change budgets.
- **Ad and keyword admin:** Create responsive search ads and keywords with match types.
- **Confirmation and paused starts:** Changes need confirm: true and new items start paused.

## Good for

- List search terms with spend and no conversions
- Compare this week with last week by campaign
- Pause the campaign with the highest cost per conversion
- Draft a paused campaign for review
- Switch between client accounts under a manager account

## Install

### Claude Code (Terminal)

```sh
claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_OAUTH_CLIENT_ID='<GOOGLE_OAUTH_CLIENT_ID>' --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-ads-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "google-ads-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_OAUTH_CLIENT_ID": "<GOOGLE_OAUTH_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

## Tools

- `ads_list_accounts`: List reachable customer accounts.
- `ads_account_info`: Account name, currency, time zone and manager status.
- `ads_campaigns`: Campaigns with status, budget and metrics.
- `ads_ad_groups`: Ad groups with metrics.
- `ads_ads`: Ads with headlines, descriptions and metrics.
- `ads_keywords`: Keyword performance.
- `ads_search_terms`: Search terms report.
- `ads_performance`: Account or per-campaign totals for a date range.
- `ads_query`: Run a read-only GAQL query.
- `ping`: Check the server is running.
- `ads_campaign_admin`: Create and manage search campaigns.
- `ads_ad_group_admin`: Create and manage ad groups.
- `ads_ad_admin`: Create and manage responsive search ads.
- `ads_keyword_admin`: Add and manage keywords.

## FAQ

### Is it Google's official server?

No, it is an independent extension using your own developer token.

### Can it spend without asking?

Every admin action needs confirmation and new items are created paused.

### Does it cost anything?

The extension is free and MIT licensed; you pay Google for ads as usual.

### What do I need first?

A Google Ads account, an approved developer token, OAuth credentials and your customer ID.

### Is Google Ads MCP free?

Yes. Google Ads MCP is open source, so you can use and self-host it for free.

### How do I add Google Ads MCP to Claude Code?

Run this command in your terminal: claude mcp add google-ads-mcp --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_OAUTH_CLIENT_ID='<GOOGLE_OAUTH_CLIENT_ID>' --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-ads-mcp

### What are the best alternatives to Google Ads MCP?

The closest alternatives to Google Ads MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/google-ads-mcp-2
