←back to Blog

Google Open-Sources an MCP Server for the Google Ads API, Bringing LLM-Native Access to Ads Data

Understanding the Audience for Google Open-Sourced MCP Server for the Google Ads API

The target audience for the Google Open-Sourced MCP Server includes digital marketing professionals, developers, data analysts, and growth teams working in the advertising landscape. These individuals often leverage large language models (LLMs) and are looking for efficient ways to access and analyze ad campaign data.

Pain Points: This audience typically faces challenges related to integrating various systems for ad management and performance analytics. The complexity of APIs and the need for specialized skill sets to write custom SDKs can slow down workflows and hinder insights.

Goals: Their primary goals include streamlining data access, enhancing operational efficiency, and enabling data-driven decision-making. By using LLMs, they aim to simplify processes such as query generation and customer resource enumeration.

Interests: The target persona is keen on technologies that facilitate automation and enhance productivity. This includes tools that improve integration with external systems and those that enable real-time data analysis.

Communication Preferences: This audience prefers direct and technical communication, often through channels like developer forums, technical blogs, and GitHub repositories. Clear, concise documentation is vital for facilitating their understanding and adoption of new technologies.

Google Open-Sources MCP Server for Google Ads API

Google has open-sourced a Model Context Protocol (MCP) server that provides read-only access to the Google Ads API for agentic and LLM applications. The repository googleads/google-ads-mcp implements an MCP server in Python, exposing two initial tools: search (GAQL queries over Ads accounts) and list_accessible_customers (customer resource enumeration). This project is deemed “Experimental.”

Why It Matters

The introduction of the MCP server represents a pivotal shift in how large language models can integrate with external systems. By providing a reference server for the Ads API, Google simplifies the integration process for LLM agents who require campaign telemetry and performance diagnostics without needing to develop bespoke SDKs.

How It Works (Developer View)

Protocol: MCP standardizes tools that models can invoke with typed parameters and responses. The Ads MCP server makes tools available that map to Google Ads API operations. These tools can be discovered and invoked by MCP clients (such as Gemini CLI and Code Assist) during a session.

Auth & Scopes: To use the Google Ads API, developers need to enable it in a Cloud project, obtain a developer token, and configure Application Default Credentials or the Ads Python client. The required OAuth2 scope is adwords. For manager-account hierarchies, it’s necessary to set a login customer ID.

Client Configuration: Developers must add their configuration in the settings.json file to point to the MCP server invocation and pass credentials via environment variables. Queries can then be made through the MCP endpoint in Gemini, allowing users to prompt for specific data, such as campaign performance.

Ecosystem Signal

The launch of Google’s server aligns with a broader trend of MCP adoption across various vendors, reinforcing MCP as a realistic approach to ensuring interoperability between agents and Software as a Service (SaaS) platforms. For pay-per-click (PPC) and growth teams, this reference server provides a practical means to test LLM-assisted quality assurance, anomaly detection, and reporting capabilities without requiring write access.

Key Takeaways

  • Google has open-sourced a read-only Google Ads API MCP server, featuring tools for search (GAQL) and customer enumeration.
  • The project is available as a Python implementation on GitHub and is licensed under Apache-2.0, although it is marked as Experimental.
  • Installation requires pipx and configuration with OAuth2 (adwords scope) and dev token management.
  • MCP-compatible clients enable agents to perform GAQL queries and analyze Ads accounts through natural language.

Conclusion

Google’s open-sourcing of the Google Ads API MCP server provides teams with a standardized, read-only pathway for LLM agents to execute GAQL queries against Ads accounts. This repository facilitates users in gathering insights without complex SDK integration. Developers should remember to manage OAuth scope, developer tokens, and data exposure carefully, as outlined in the project README.

Additional Resources

For further information and resources, visit the GitHub Page for Tutorials, Codes, and Notebooks. Stay updated by following our Twitter and joining our community on ML SubReddit, with over 100K subscribers. You can also subscribe to our Newsletter and join us on Telegram.