</>MCP Agents Market
MCP Server

google-ads-mcp

by googleads931PythonUpdated 2026-09-10

Antigravity CLIAntigravity Code AssistClaude CodeCursorVS Code

The Google Ads MCP server enables AI agents and LLMs to interact with the Google Ads API through the Model Context Protocol. It provides tools for searching account information, retrieving resource metadata, and listing accessible customers, along with resources like the API discovery document, metrics, segments, and release notes. The server supports flexible authentication options including FastMCP OAuth proxy for web deployments and Application Default Credentials for local use. It can be deployed locally or hosted on cloud infrastructure like Google Cloud Run for shared access across multiple agents.

Key Features

Search tool to retrieve Google Ads account information via API queries
Resource metadata retrieval to understand campaign, ad group, and other entity structures
List accessible customers to discover available Google Ads accounts
Discovery document, metrics, and segments resources for API exploration
Configurable tool namespacing through tools_config.yaml for selective feature enablement
FastMCP OAuth proxy support for dynamic user authentication in web deployments
Multiple authentication methods: OAuth proxy, Application Default Credentials, or Python client library config
Cloud Run deployment support with Firestore or Redis storage for OAuth tokens

Use Cases

  • 01Query campaign performance metrics and spending data through conversational AI interfaces
  • 02Automate Google Ads account analysis and reporting via LLM-powered agents
  • 03Explore available Google Ads API resources and fields without manual documentation lookup
  • 04Build multi-tenant advertising management tools with OAuth-based user authentication
  • 05Deploy shared Google Ads data access for teams using cloud-hosted MCP servers
  • 06Integrate Google Ads insights into AI-assisted marketing workflow automation

Related MCP Servers

View more

google-ads-mcp — FAQ

What is the Google Ads MCP server?+

The Google Ads MCP server is an official Model Context Protocol implementation that enables AI agents and LLMs to query and interact with Google Ads accounts through the Google Ads API. It exposes tools for searching account data, retrieving metadata, and accessing API documentation.

How do I install the Google Ads MCP server?+

Install using pipx with 'pipx run --spec google-ads-mcp google-ads-mcp' or install from the GitHub repo. You'll need to configure authentication via OAuth credentials or Application Default Credentials, enable the Google Ads API in your Google Cloud project, and add the server configuration to your MCP client's settings file.

Which MCP clients work with this server?+

The server works with Antigravity CLI, Antigravity Code Assist, Claude Code, Cursor, VS Code with Copilot, and other MCP-compatible clients. All clients use the same mcpServers configuration format in their respective settings files.

Do I need a Google Ads developer token?+

A developer token is optional for some setups but required for production account access in most cases. If you receive an error about test account limitations, you need to obtain a developer token with at least Explorer access level from the Google Ads API Center.

Is the Google Ads MCP server free to use?+

The MCP server software itself is open source and free. However, you need a Google Cloud project (which may incur costs) and access to Google Ads accounts. API usage follows standard Google Ads API quotas and billing.

What authentication credentials are required?+

You need Google Cloud OAuth 2.0 credentials with the Google Ads API scope (https://www.googleapis.com/auth/adwords). Options include configuring Application Default Credentials via gcloud, setting up FastMCP OAuth with client ID and secret, or using existing google-ads.yaml configuration from the Python client library.

How do I install google-ads-mcp?+

Open the source repository on GitHub and follow its README. google-ads-mcp is a mcp server — MCP Agents Market links you directly to the official repo.

Is google-ads-mcp free?+

google-ads-mcp is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches