Google Ads

Google Ads

A FastMCP-powered MCP server for Google Ads API integration with automatic OAuth 2.0 authentication.

81
Stars
28
Forks
0
Releases

Overview

Google Ads MCP Server is a FastMCP-powered MCP server that provides a seamless bridge between the Google Ads API and MCP clients such as Claude Desktop. It offers automatic OAuth 2.0 authentication with a one-time browser flow and automatic token refresh, smart token management to handle token expiry, and GAQL query execution to fetch or analyze data using Google Ads Query Language. The server supports account discovery and management, enabling listing and management of Google Ads accounts, and includes a keyword research capability to generate keyword ideas with search volume data. It is built on the FastMCP framework and is designed to be Claude Desktop ready for direct integration, with secure local storage of tokens. Setup includes one-click installers and straightforward environment configuration (.env) with developer token and OAuth credentials. The README provides example commands (list_accounts, run_gaql, run_keyword_planner) and usage patterns, as well as advanced GAQL examples and a project structure. It emphasizes security best practices, token storage, and production considerations such as environment variables and rate limiting.

Details

Owner
gomarble-ai
Language
Python
License
MIT License
Updated
2025-12-07

Features

Automatic OAuth 2.0

One-time browser authentication with auto-refresh.

Smart Token Management

Handles expired tokens automatically.

GAQL Query Execution

Run GAQL queries against Google Ads data.

Account Management

List and manage Google Ads accounts.

Keyword Research

Generate keyword ideas with search volume data.

FastMCP Framework

Built on the modern MCP standard.

Claude Desktop Ready

Direct integration with Claude Desktop.

Secure Local Storage

Tokens stored locally, never exposed.

Audience

AdvertisersAccess Google Ads data and management via MCP clients like Claude Desktop.

Tags

Google AdsMCPOAuth 2.0GAQLKeyword ResearchAccount ManagementClaude DesktopFastMCPGoogle Ads API