Google Ads

Name: Google Ads
Author: ZLeventer

Community

MCP server by ZLeventer · updated 5 months ago · ★ 1

Score 30

MCP server for Google Ads — 22 tools for spend diagnosis, impression share, and asset performance. Google Ads is a community project by ZLeventer, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit 177 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL

Security

Not checked yet. What we check

What you need

Setting	Needed	What it is
`GOOGLE_ADS_DEVELOPER_TOKEN`Environment variable, secret	Required	Google Ads developer token (apply at https://developers.google.com/google-ads/api/docs/get-started/dev-token)
`GOOGLE_ADS_CLIENT_ID`Environment variable, secret	Required	OAuth 2.0 client ID from Google Cloud Console
`GOOGLE_ADS_CLIENT_SECRET`Environment variable, secret	Required	OAuth 2.0 client secret from Google Cloud Console
`GOOGLE_ADS_REFRESH_TOKEN`Environment variable, secret	Required	OAuth 2.0 refresh token with https://www.googleapis.com/auth/adwords scope
`GOOGLE_ADS_CUSTOMER_ID`Environment variable	Required	Default Google Ads customer ID (numeric, no dashes). Can be overridden per tool call.
`GOOGLE_ADS_LOGIN_CUSTOMER_ID`Environment variable	Optional	Manager (MCC) account ID — required only if accessing accounts under an MCC

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install Google Ads

Built from the published package, never by AI

claude mcp add google-ads -e GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_GOOGLE_ADS_DEVELOPER_TOKEN -e GOOGLE_ADS_CLIENT_ID=YOUR_GOOGLE_ADS_CLIENT_ID -e GOOGLE_ADS_CLIENT_SECRET=YOUR_GOOGLE_ADS_CLIENT_SECRET -e GOOGLE_ADS_REFRESH_TOKEN=YOUR_GOOGLE_ADS_REFRESH_TOKEN -e GOOGLE_ADS_CUSTOMER_ID=YOUR_GOOGLE_ADS_CUSTOMER_ID -- npx -y @zleventer/google-ads-mcp

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install Google Ads in Claude Code

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_GOOGLE_ADS_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_GOOGLE_ADS_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_GOOGLE_ADS_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "YOUR_GOOGLE_ADS_CUSTOMER_ID"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install Google Ads in Claude Desktop

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_GOOGLE_ADS_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_GOOGLE_ADS_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_GOOGLE_ADS_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "YOUR_GOOGLE_ADS_CUSTOMER_ID"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install Google Ads in Cursor

{
  "servers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_GOOGLE_ADS_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_GOOGLE_ADS_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_GOOGLE_ADS_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "YOUR_GOOGLE_ADS_CUSTOMER_ID"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install Google Ads in VS Code

codex mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_GOOGLE_ADS_DEVELOPER_TOKEN --env GOOGLE_ADS_CLIENT_ID=YOUR_GOOGLE_ADS_CLIENT_ID --env GOOGLE_ADS_CLIENT_SECRET=YOUR_GOOGLE_ADS_CLIENT_SECRET --env GOOGLE_ADS_REFRESH_TOKEN=YOUR_GOOGLE_ADS_REFRESH_TOKEN --env GOOGLE_ADS_CUSTOMER_ID=YOUR_GOOGLE_ADS_CUSTOMER_ID -- npx -y @zleventer/google-ads-mcp

Step-by-step: install Google Ads in Codex

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_GOOGLE_ADS_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_GOOGLE_ADS_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_GOOGLE_ADS_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "YOUR_GOOGLE_ADS_CUSTOMER_ID"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install Google Ads in Antigravity CLI

gemini mcp add google-ads npx -y @zleventer/google-ads-mcp

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install Google Ads in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the google-ads block.

Weekly newsletter

Like Google Ads? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to Google Ads

All alternatives →

Linkedin MCP server stickerdaniel

Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.

AAA Local 4.0k

Nooticr Nooticr

Social intelligence for 10 networks: read posts and trends, monitor brand mentions, then create.

AAC Local and remote 3.7k/wk

Plunk MCP useplunk

Official Model Context Protocol server for Plunk — send email, manage contacts, campaigns and segments from an AI agent

ACA Local 5.5k

Thesvg MCP Server glincker

MCP server for searching and fetching 6,500+ brand SVGs from thesvg.org

AAA Local 2.9k

openshortsmutonby

Turn long videos into viral vertical shorts and publish them to TikTok, Instagram and YouTube.

AAA Remote 6.8k

TokPortal tokportal

Managed TikTok/Instagram/YouTube accounts + video posting at scale, operated by human managers.

AAC Local and remote 2.4k/wk

Google Ads vs Linkedin MCP server Google Ads vs Nooticr Google Ads vs Plunk MCP

Google Ads: common questions

How do I install Google Ads?

In Claude Code run claude mcp add google-ads -e GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_GOOGLE_ADS_DEVELOPER_TOKEN -e GOOGLE_ADS_CLIENT_ID=YOUR_GOOGLE_ADS_CLIENT_ID -e GOOGLE_ADS_CLIENT_SECRET=YOUR_GOOGLE_ADS_CLIENT_SECRET -e GOOGLE_ADS_REFRESH_TOKEN=YOUR_GOOGLE_ADS_REFRESH_TOKEN -e GOOGLE_ADS_CUSTOMER_ID=YOUR_GOOGLE_ADS_CUSTOMER_ID -- npx -y @zleventer/google-ads-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is Google Ads the official server?

Google Ads is a community project by ZLeventer, not verified by a company domain.

Is Google Ads free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is Google Ads safe to use?

It scores 30 of 100. Grades: maintenance C, licence A, quality D. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to Google Ads?

Similar MCP servers: Linkedin MCP server, Nooticr, Plunk MCP, Thesvg MCP Server.

Does Google Ads work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.