google-ads-mcp

Configure an MCP server for Claude access to Google Ads API data.

1|2|Updated May 21, 2026
One-click install
npx skills add https://github.com/itallstartedwithaidea/claude-googleadsagent --skill google-ads-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-ads-mcp
Source: https://github.com/itallstartedwithaidea/claude-googleadsagent/tree/main/skills/google-ads-mcp
Command: npx skills add https://github.com/itallstartedwithaidea/claude-googleadsagent --skill google-ads-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of configuring safe, authenticated access from Claude to the Google Ads API so you can run reporting and analysis against your real campaigns without manual exports.

Core Features & Use Cases

  • MCP server setup for live Google Ads access: Configure and run the google-ads-mcp server so an MCP-capable client (Claude Code/Desktop/Cursor) can query your account.
  • Credential and environment configuration: Use either environment variables or a GOOGLE_ADS_CREDENTIALS YAML path to authenticate reliably.
  • Workflow-ready GAQL querying and troubleshooting: Supports GAQL-based reads plus guardrails for preview/dry-run behavior on write operations.

Quick Start

Set your OAuth and login credentials in a local .env file (or point to a google-ads.yaml via GOOGLE_ADS_CREDENTIALS), then run python -m ads_mcp.server and configure your .mcp.json/claude_desktop_config.json to load the google-ads MCP server.

Frequently Asked Questions about google-ads-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Claude to live Google Ads data for campaign reporting?

To connect Claude to live Google Ads data, configure an MCP server using authenticated OAuth credentials, developer tokens, and a refresh token, then load the server via your client's .mcp.json configuration file.

Can I run GAQL queries against my Google Ads account through an MCP client?

Yes, you can run GAQL queries for reporting and keyword analysis by configuring the google-ads MCP server in Claude Desktop or Cursor to access your authenticated Google Ads API data.

What credentials do I need to set up a Google Ads MCP server?

Setting up the Google Ads MCP server requires OAuth configuration including a developer token, client credentials, a refresh token, and a login customer ID stored in a local environment file or YAML path.

Does the Google Ads MCP integration support write operations like budget updates?

The Google Ads MCP integration supports controlled write operations like budget and status updates, applying guardrails with a dry-run default to prevent accidental changes to your live campaigns.

How do I troubleshoot OAuth authentication issues with the Google Ads API in Claude?

Troubleshoot Google Ads API OAuth issues by verifying your developer token, client credentials, and refresh token are correctly set in your environment variables or GOOGLE_ADS_CREDENTIALS YAML configuration path.

What is the best way to analyze search-term performance from Google Ads without manual exports?

The best way to analyze search-term performance without manual exports is using an MCP server to query live Google Ads API data directly, enabling real-time campaign investigation and optimization workflows.