Google Ads Mcp Server

Name: Google Ads Mcp Server
Author: gomarble-ai

@gomarble-ai

Repository

About Google Ads Mcp Server

A FastMCP-powered Model Context Protocol server for Google Ads API integration with automatic OAuth 2.0 authentication

#google-ads #mcp-server #api-integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-ads": {
      "command": "/full/path/to/your/project/.venv/bin/python",
      "args": [
        "/full/path/to/your/project/server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Ads MCP Server?

A FastMCP-powered Model Context Protocol server that integrates the Google Ads API with MCP clients like Claude Desktop, featuring automatic OAuth 2.0 authentication, token refresh, GAQL query execution, and keyword research.

How to use Google Ads MCP Server?

Install Python 3.10+, clone the repository, create a virtual environment, install dependencies, configure a .env file with your Google Ads developer token and OAuth credentials path, then add the server to Claude Desktop’s claude_desktop_config.json. After a one-time browser-based OAuth flow, you can issue commands like “List all my Google Ads accounts” or run GAQL queries.

Key features of Google Ads MCP Server

Automatic OAuth 2.0 with one-time browser authentication
Smart token management with automatic refresh
Execute any GAQL query on Google Ads accounts
List and manage Google Ads accounts
Generate keyword ideas with search volume data
Built on FastMCP for modern MCP standards
Ready for direct integration with Claude Desktop
Tokens stored locally and never exposed

Use cases of Google Ads MCP Server

List all accessible Google Ads accounts and identify active campaigns
Analyze campaign performance, clicks, conversions, and costs with GAQL queries
Perform keyword research to discover new opportunities with search volume metrics
Monitor device performance breakdown across campaigns
Retrieve keyword-level metrics like CTR, average CPC, and quality score

FAQ from Google Ads MCP Server

What does this server do that alternatives don’t?

It provides seamless OAuth 2.0 authentication and automatic token refresh, allowing you to run GAQL queries and keyword research directly from MCP clients without managing authentication manually.

What are the runtime dependencies?

Python 3.10+ is required, along with a Google Cloud Platform project, a Google Ads account with API access, and a developer token (initially a test token, then production access after approval).

Where are authentication tokens stored?

Tokens are stored locally in a google_ads_token.json file in the project directory; credential files are gitignored and never committed to version control.

How does the authentication flow work?

On first use, the server opens your browser to Google’s OAuth page. After you sign in and grant permissions, the token is saved locally and automatically refreshed when needed.

Are there any known limits?

The initial developer token is a test token with limited functionality. Production access requires a separate approval process through the Google Ads API Center.

Comments

More Developer Tools MCP servers

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K