# Google Ads

> Google Ads is an open-source MCP server for marketing and seo. Read Google Ads performance and prepare confirmed changes from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Starting price:** $39 a month
- **Platforms:** CLI, self-hosted, API
- **Website:** https://www.getmcpads.com/tools/google-ads
- **Repository:** https://github.com/get-mcp-ads/google-ads-mcp-server
- **MCP Registry name:** com.getmcpads/google-ads
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-15

## About

Reading is the default; writing is opt-in. The npm package ships 35 read tools covering campaign performance, search terms, Performance Max assets, Shopping products, change history and Keyword Planner research, plus raw GAQL queries. Another 13 write tools stay hidden until GOOGLE_ADS_ENABLE_WRITES is set to true, and even then each call only previews a change until confirm:true is passed.

This open-source package runs locally over stdio with your own credentials: a Google Ads developer token (Basic Access or above), an OAuth client ID, secret and refresh token, and optionally a manager account ID. GOOGLE_ADS_ACCOUNT_IDS can restrict every tool to a list of customers, and the README says it becomes required in 3.0.0. It pins Google Ads API v26 and needs a recent Node.js 22, 24 or 26 release.

The maker, Get MCP Ads, also offers a hosted version with Google sign-in, account picking and extras such as dashboards, alerts and Sheets exports. Those belong to the hosted product, not this package.

## Features

- **35 read tools:** Reports on campaigns, search terms, Performance Max, Shopping and change history.
- **Opt-in writes:** 13 write tools appear only when GOOGLE_ADS_ENABLE_WRITES is true.
- **Preview before apply:** Write calls preview by default and apply only with confirm:true.
- **Raw GAQL:** Run Google Ads Query Language queries directly against API v26.
- **Account allow-list:** GOOGLE_ADS_ACCOUNT_IDS limits every tool to the customers you list.
- **Keyword Planner:** Keyword ideas, historical metrics and forecasts from the conversation.

## Good for

- Ask which search terms drove spend last month
- Review Performance Max asset results
- Pause a campaign or change a daily budget after a preview
- Research keyword ideas and forecasts
- Limit an assistant to a few client accounts under a manager account

## Install

### Claude Code (Terminal)

```sh
claude mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' -- npx -y @getmcpads/google-ads-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-ads-mcp-server"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-ads-mcp-server"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "google-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-ads-mcp-server"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-ads-mcp-server"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-ads-mcp-server"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>"
      }
    }
  }
}
```

## Tools

- `google_ads_run_gaql`: Runs raw GAQL queries against Google Ads API v26.
- `google_ads_run_readonly_rpc`: Sends read-only RPC requests, also following API v26.

## FAQ

### Can it change my campaigns?

Only if you set GOOGLE_ADS_ENABLE_WRITES to true. Even then, calls preview by default and apply changes only with confirm:true.

### What credentials does it need?

A Google Ads developer token, OAuth client ID, client secret and refresh token; a manager account ID is optional.

### Is there a hosted option?

Yes. Get MCP Ads offers a hosted connection with Google sign-in. Its Free plan covers 1 ad account with 200 requests a month; Pro is $39/month.

### Which Node.js versions work?

Node.js 22.23.4, 24.22.1 or 26.12.1, or a newer release of those lines.

### Is Google Ads free?

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

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

Run this command in your terminal: claude mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' -- npx -y @getmcpads/google-ads-mcp-server

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

The closest alternatives to Google Ads 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-4
