Google Ads, verificado
Servidor MCP de Google · Verificado
Query Google Ads accounts with GAQL and inspect campaign data and performance metrics through the Google Ads API.
Instalar Google Ads
Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:
Requiere pipx (Python) en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.
GOOGLE_ADS_DEVELOPER_TOKENsecreto Google Ads API developer token.GOOGLE_PROJECT_IDGoogle Cloud project ID (credentials come from ADC or GOOGLE_APPLICATION_CREDENTIALS).
Compartir este servidor
Abre esta página, con el comando de instalación y los pasos de configuración.
mcp.tc/i/google-adsDescripción
Connects to the Google Ads API so an assistant can search account data, run GAQL queries, look up resource metadata and list the customer accounts the signed-in user can access. Resources expose the API discovery document, available metrics and segments, and release notes.
Runs locally over stdio with pipx (pipx run google-ads-mcp). It needs Google credentials (Application Default Credentials or a credentials file), a Google Cloud project with the Google Ads API enabled, and a Google Ads developer token with at least Explorer access for production accounts. An optional OAuth proxy mode serves streamable HTTP.
Qué puedes hacer
- Run searches and GAQL queries against Google Ads accounts
- Get metadata and available fields for a Google Ads resource such as campaign
- List customer accounts accessible to the authenticated user
- Read the Google Ads API discovery document, metrics and segments
- Read the latest Google Ads API release notes
- Enable or rename tools through a tools_config.yaml file
Herramientas
Google Ads solo muestra sus herramientas a clientes con clave, así que no podemos listarlas aquí.
Prompts de ejemplo
List the Google Ads customer accounts I can access
Show clicks, cost and conversions per campaign for the last 30 days
What fields can I query on the ad_group resource?
Which campaigns had the highest cost per conversion last week?
Configuración
Todos los clientes inician Google Ads en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.
Claude Code
- Run this in a terminal, in your project folder:
claude mcp add --transport stdio google-ads --env "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" --env "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" -- pipx run google-ads-mcp- Start Claude Code and type
/mcp. google-ads should show as connected.
Add --scope user to make it available in every project. Replace the placeholders with your own values.
Claude Desktop
- Open Settings → Developer → Edit Config. It opens
claude_desktop_config.json. Add:
{
"mcpServers": {
"google-ads": {
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
}
}- Save the file and restart Claude Desktop. Replace the placeholders with your own values.
Needs pipx (Python) on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.
Cursor
Añadir a Cursor (se abre en una pestaña nueva)
Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):
{
"mcpServers": {
"google-ads": {
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
}
}Needs pipx (Python) on your computer. Replace the placeholders with your own values.
VS Code
Add it to .vscode/mcp.json. VS Code asks for the secret the first time and stores it securely:
{
"servers": {
"google-ads": {
"type": "stdio",
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "${input:google-ads-developer-token}",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "google-ads-developer-token",
"description": "GOOGLE_ADS_DEVELOPER_TOKEN",
"password": true
}
]
}Needs pipx (Python) on your computer.
Devin Desktop
- Add it to
~/.config/devin/mcp_config.json(macOS and Linux) or%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"google-ads": {
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
}
}- Refresh the MCP server list in Cascade. Replace the placeholders with your own values.
Devin Desktop is the new name for Windsurf.
Codex
codex mcp add google-ads --env "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" --env "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" -- pipx run google-ads-mcpOr edit ~/.codex/config.toml directly:
[mcp_servers.google-ads]
command = "pipx"
args = ["run", "google-ads-mcp"]
env = { GOOGLE_ADS_DEVELOPER_TOKEN = "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>", GOOGLE_PROJECT_ID = "<YOUR_GOOGLE_PROJECT_ID>" }Needs pipx (Python) on your computer. Replace the placeholders with your own values.
Gemini CLI
gemini mcp add -e "GOOGLE_ADS_DEVELOPER_TOKEN=<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>" -e "GOOGLE_PROJECT_ID=<YOUR_GOOGLE_PROJECT_ID>" google-ads pipx run google-ads-mcpThis adds it to the current project. Add -s user to use it everywhere.
Any client
Most clients that start local servers accept this shape:
{
"mcpServers": {
"google-ads": {
"command": "pipx",
"args": [
"run",
"google-ads-mcp"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_PROJECT_ID": "<YOUR_GOOGLE_PROJECT_ID>"
}
}
}
}Zed puts servers under context_servers in its settings, with the same command, args and env fields.
Needs pipx (Python) on your computer. Replace the placeholders with your own values.
Preguntas frecuentes
Can I paste mcp.tc/i/google-ads into my MCP client?
No. Google Ads runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is pipx run google-ads-mcp.
Does Google Ads need an API key?
Yes. It reads GOOGLE_ADS_DEVELOPER_TOKEN y GOOGLE_PROJECT_ID from its environment, and GOOGLE_ADS_DEVELOPER_TOKEN is a secret. Put the value in your client’s config on your own machine, never in a shared file.
Is Google Ads a remote or a local server?
Local. Your client starts it as a process on your computer with pipx run google-ads-mcp, which needs pipx (Python).
What can Google Ads do?
You can run searches and GAQL queries against Google Ads accounts, get metadata and available fields for a Google Ads resource such as campaign y list customer accounts accessible to the authenticated user.
Which clients can use it?
Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.
Who wrote this page?
mcp.tc’s robot read Google Ads’s public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.
Insertar
Muestra Google Ads en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones
Insignia para README
[](https://mcp.tc/i/google-ads)<a href="https://mcp.tc/i/google-ads"><img src="https://mcp.tc/i/google-ads/badge.svg" alt="Google Ads on mcp.tc" height="20"></a>Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.
Tarjeta para web
<script src="https://mcp.tc/w/google-ads.js" async></script>La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.
iframe
<iframe src="https://mcp.tc/embed/google-ads" title="Google Ads on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.
JSON
La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).
https://mcp.tc/i/google-ads.jsonmcp.tc no tiene relación con Google. Esta página se creó a partir de los metadatos públicos de Google Ads, comprobados por última vez el 3 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha.