Relaticle
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
Google Ads MCP server: 35 read tools, 13 opt-in preview-first writes.
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Google Ads (créala en el sitio del autor) · 2 ajuste(s) que rellenar (GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Google Ads para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "google-ads": { "command": "npx", "args": [ "-y", "@getmcpads/google-ads-mcp-server" ], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "your-value", "GOOGLE_ADS_CLIENT_ID": "your-value", "GOOGLE_ADS_CLIENT_SECRET": "your-value", "GOOGLE_ADS_REFRESH_TOKEN": "your-value", "GOOGLE_ADS_ACCOUNT_IDS": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Google Ads aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
GOOGLE_ADS_CLIENT_ID OAuth client ID.GOOGLE_ADS_ACCOUNT_IDS Comma-separated customer IDs every tool is limited to. Optional in 2.x, required in 3.0.0.Las descripciones siguen en el inglés original.
SettingsDeveloperEdit Config
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-value",
"GOOGLE_ADS_CLIENT_ID": "your-value",
"GOOGLE_ADS_CLIENT_SECRET": "your-value",
"GOOGLE_ADS_REFRESH_TOKEN": "your-value",
"GOOGLE_ADS_ACCOUNT_IDS": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Google Ads y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Google Ads o muestra una herramienta de Google Ads en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GOOGLE_ADS_LOGIN_CUSTOMER_ID Manager (MCC) account ID, when the customer sits under one.GOOGLE_ADS_ENABLE_WRITES Set to true to expose 13 write tools. Calls preview by default; confirm:true applies changes.Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Google Ads
Google Ads se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Google Ads
B · Otros en Marketing y redes sociales que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Google Ads (créala en el sitio del autor) · 2 ajuste(s) que rellenar (GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Google Ads para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=your-value --env GOOGLE_ADS_CLIENT_ID=your-value --env GOOGLE_ADS_CLIENT_SECRET=your-value --env GOOGLE_ADS_REFRESH_TOKEN=your-value --env GOOGLE_ADS_ACCOUNT_IDS=your-value -- npx -y @getmcpads/google-ads-mcp-server 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Google Ads aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
GOOGLE_ADS_CLIENT_ID OAuth client ID.GOOGLE_ADS_ACCOUNT_IDS Comma-separated customer IDs every tool is limited to. Optional in 2.x, required in 3.0.0.Las descripciones siguen en el inglés original.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=your-value --env GOOGLE_ADS_CLIENT_ID=your-value --env GOOGLE_ADS_CLIENT_SECRET=your-value --env GOOGLE_ADS_REFRESH_TOKEN=your-value --env GOOGLE_ADS_ACCOUNT_IDS=your-value -- npx -y @getmcpads/google-ads-mcp-serverCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Google Ads en la lista como conectado
Usa Google Ads y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Google Ads o muestra una herramienta de Google Ads en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GOOGLE_ADS_LOGIN_CUSTOMER_ID Manager (MCC) account ID, when the customer sits under one.GOOGLE_ADS_ENABLE_WRITES Set to true to expose 13 write tools. Calls preview by default; confirm:true applies changes.Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Google Ads (créala en el sitio del autor) · 2 ajuste(s) que rellenar (GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Google Ads para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "google-ads": { "command": "npx", "args": [ "-y", "@getmcpads/google-ads-mcp-server" ], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "your-value", "GOOGLE_ADS_CLIENT_ID": "your-value", "GOOGLE_ADS_CLIENT_SECRET": "your-value", "GOOGLE_ADS_REFRESH_TOKEN": "your-value", "GOOGLE_ADS_ACCOUNT_IDS": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Google Ads aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
GOOGLE_ADS_CLIENT_ID OAuth client ID.GOOGLE_ADS_ACCOUNT_IDS Comma-separated customer IDs every tool is limited to. Optional in 2.x, required in 3.0.0.Las descripciones siguen en el inglés original.
En la configuración de Google Ads, GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Google Ads y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Google Ads o muestra una herramienta de Google Ads en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GOOGLE_ADS_LOGIN_CUSTOMER_ID Manager (MCC) account ID, when the customer sits under one.GOOGLE_ADS_ENABLE_WRITES Set to true to expose 13 write tools. Calls preview by default; confirm:true applies changes.Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Google Ads (créala en el sitio del autor) · 2 ajuste(s) que rellenar (GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Google Ads para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "google-ads": { "type": "stdio", "command": "npx", "args": [ "-y", "@getmcpads/google-ads-mcp-server" ], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "your-value", "GOOGLE_ADS_CLIENT_ID": "your-value", "GOOGLE_ADS_CLIENT_SECRET": "your-value", "GOOGLE_ADS_REFRESH_TOKEN": "your-value", "GOOGLE_ADS_ACCOUNT_IDS": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Google Ads aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
GOOGLE_ADS_CLIENT_ID OAuth client ID.GOOGLE_ADS_ACCOUNT_IDS Comma-separated customer IDs every tool is limited to. Optional in 2.x, required in 3.0.0.Las descripciones siguen en el inglés original.
En la configuración de Google Ads, GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_ACCOUNT_IDS está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Google Ads y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Google Ads o muestra una herramienta de Google Ads en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GOOGLE_ADS_LOGIN_CUSTOMER_ID Manager (MCC) account ID, when the customer sits under one.GOOGLE_ADS_ENABLE_WRITES Set to true to expose 13 write tools. Calls preview by default; confirm:true applies changes.Las descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=your-value --env GOOGLE_ADS_CLIENT_ID=your-value --env GOOGLE_ADS_CLIENT_SECRET=your-value --env GOOGLE_ADS_REFRESH_TOKEN=your-value --env GOOGLE_ADS_ACCOUNT_IDS=your-value -- npx -y @getmcpads/google-ads-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-value",
"GOOGLE_ADS_CLIENT_ID": "your-value",
"GOOGLE_ADS_CLIENT_SECRET": "your-value",
"GOOGLE_ADS_REFRESH_TOKEN": "your-value",
"GOOGLE_ADS_ACCOUNT_IDS": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-value",
"GOOGLE_ADS_CLIENT_ID": "your-value",
"GOOGLE_ADS_CLIENT_SECRET": "your-value",
"GOOGLE_ADS_REFRESH_TOKEN": "your-value",
"GOOGLE_ADS_ACCOUNT_IDS": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"google-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-value",
"GOOGLE_ADS_CLIENT_ID": "your-value",
"GOOGLE_ADS_CLIENT_SECRET": "your-value",
"GOOGLE_ADS_REFRESH_TOKEN": "your-value",
"GOOGLE_ADS_ACCOUNT_IDS": "your-value"
}
}
}
}GOOGLE_ADS_DEVELOPER_TOKEN secreto obligatorio envGOOGLE_ADS_CLIENT_ID obligatorio envGOOGLE_ADS_CLIENT_SECRET secreto obligatorio envGOOGLE_ADS_REFRESH_TOKEN secreto obligatorio envGOOGLE_ADS_LOGIN_CUSTOMER_ID envGOOGLE_ADS_ACCOUNT_IDS obligatorio envGOOGLE_ADS_ENABLE_WRITES envLas descripciones siguen en el inglés original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
npm: @getmcpads/google-ads-mcp-serverSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026
El nombre en el registro se verificó con el dominio getmcpads.com (el registro comprueba quién es dueño del dominio)
Último cambio de código: hace 7 días
Usa Apache-2.0
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Aún no revisado
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 7 días, y la última versión (2.1.2) llegó al registro hace 7 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Explore performance, research keywords and prepare campaign changes from your MCP client.
Watch the film · What's new · Install · Tool reference · Try hosted getmcpads
[Play the 45-second film](https://www.getmcpads.com/home/film/get-mcp-ads-brand-film-1080p.mp4)
The film shows hosted getmcpads with sample data. Its MCP Apps, from creative galleries and alerts to Google Sheets exports and bulk launches, belong to the hosted product. This repository provides the standalone native API tools.
35 read tools · 13 write tools, disabled by default.
Run locally with your own platform credentials and a client that supports stdio MCP, such as Claude Desktop, Claude Code or Cursor. Your requests go directly to the platform. For managed connections, including supported ChatGPT setups, use the hosted option.
[v2.1.1: Zod 4 security update](https://github.com/get-mcp-ads/google-ads-mcp-server/releases/tag/v2.1.1) · October 26, 2026
zod to 4.6.7. Every Zod release before 4.6.6 is covered by the high-severity advisory GHSA-mrhx-c7xc-m3w5: validating an oversized constrained collection can exhaust memory, and no Zod 3 release carries the fix. npm audit --omit=dev reports no vulnerability again.server-card.json is regenerated with Zod 4's JSON Schema output, which spells some constraints differently.Earlier releases
| Version | Date | Highlights |
|---|---|---|
| 2.1.0 | October 23, 2026 | Renames, Google Ads API v26 and Search Lift |
| 2.0.1 | September 23, 2026 | Public repository restored |
| 2.0.0 | September 20, 2026 | Gateway sync and security fixes |
| 1.1.0 | September 13, 2026 | Platform capability sync and quality contracts |
| 1.0.2 | August 30, 2026 | Announce the package version over MCP. |
| 1.0.1 | August 30, 2026 | Add server.json and mcpName for the official MCP Registry, under com.getmcpads/google-ads. |
| 1.0.0 | August 29, 2026 | First open-source release |
Source synchronization: SOURCE_SYNC.md.
Requires Node.js 22.23.4, 24.22.1 or 26.12.1, or a newer release of one of these lines. Older releases lack the October 2026 security fixes, and the server prints a warning on stderr when it starts on one. CI covers Node 22, 24 and 26.
This release makes no breaking change to the configuration. Two changes are announced for 3.0.0:
GOOGLE_ADS_ACCOUNT_IDS is optional in 2.x. When set, every tool is limited to the listed customers. When unset, the server starts as before and prints one line on stderr recommending it. It becomes required in 3.0.0.GOOGLE_ADS_ENABLE_WRITES still accepts 1, yes and on, and prints one deprecation line on stderr. Use true, the only value 3.0.0 will accept.The server pins Google Ads API v26. Raw queries sent through google_ads_run_gaql and google_ads_run_readonly_rpc follow v26 as well. A query that reads customer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled or a hotel field of ad_group_bid_modifier must use the v26 names listed in Google's v26 release notes. Writes remain optional and require explicit confirmation.
This is a GitHub source release. npm and MCP Registry versions are published separately. The commands below select this exact version; unpinned npx examples later in this document select the version currently available on npm.
git clone --branch v2.1.1 --depth 1 https://github.com/get-mcp-ads/google-ads-mcp-server.git
cd google-ads-mcp-server npm ci npm run build
Configure your MCP client to run node with the absolute path to dist/cli.js and the platform credentials documented below.
Prefer a managed connection? Use Google Ads with hosted getmcpads. Connect your account, select the data your assistant may access and use the hosted MCP connection. See the site for current features and plans.
| 35 read tools | Campaigns, ad groups, budgets, bidding strategies, search terms, landing pages, Performance Max assets and placements, Shopping, recommendations, change history |
| 13 write tools | Off by default. Status, budgets, bids, schedules, renames, campaign creation. Each one previews before it applies |
| Full Keyword Planner | Keyword ideas, historical metrics, forecasts, ad group themes, geo target suggestions |
| 145 metrics, 88 dimensions | With a compatibility matrix that catches invalid combinations before they hit the API |
| Google Ads API v26 | The version this release pins, including the Search Lift metrics read from lift_measurement_config |
| 5 resources | Live catalogues the model can read: metrics, dimensions, compatibility rules, 11 workflow recipes |
| GAQL and beyond | google_ads_run_gaql for raw queries, and google_ads_run_readonly_rpc for the services GAQL cannot reach |
The Google Ads API is queried with GAQL, its own query language, and most of its surface is only reachable that way. This server carries the metric and dimension catalogues, so the model asks for cost and conversions by name and the server writes the query.
google_ads_validate_query lets it check a combination before spending a call on it, and google_ads_run_gaql is still there when you want to write GAQL yourself.
Keyword ideas, historical volumes and forecasts live in a separate RPC service that GAQL cannot reach at all. Same for Reach Planner, audience insights and benchmarks. This server covers them through google_ads_run_readonly_rpc and dedicated tools.
This is the heaviest setup of any advertising platform. Four values are needed, and one of them requires a review by Google. Budget an hour the first time.
From a manager (MCC) account, open Tools → API Center and apply for a token. It starts at *Test Account* level, which only reaches test accounts. Apply for Basic Access to reach live accounts. Google reviews the application, which can take a few days.
📖 Developer token documentation
In a Google Cloud project, enable the Google Ads API, then create an OAuth client under APIs & Services → Credentials. Choose Desktop app for local use. Note the client ID and client secret.
Run the OAuth consent flow once, signed in as the Google account that can see your ad accounts, and keep the refresh token it returns. Google's own helper script does this in one command.
The refresh token does not expire. It is the sensitive value here: anyone holding it can mint access tokens indefinitely. Treat it like a password, and use an OAuth client dedicated to this server so you can revoke it on its own.
If the accounts you query sit under an MCC, set GOOGLE_ADS_LOGIN_CUSTOMER_ID to the manager account ID. Dashes are accepted and stripped. Skip it for a standalone account.
You can also leave it unset. Google refuses any request against a managed account unless the call names its manager, with a USER_PERMISSION_DENIED that mentions neither the account nor the manager, so it reads as missing access rather than as a missing header. When the variable is unset and the account you query is not directly accessible, the server asks the managers it can reach which accounts they hold, and announces the one that holds yours. The answer is resolved once and kept for the life of the process.
Setting the variable is still faster: it skips that discovery entirely, and it is the right choice when every account you query sits under the same MCC.
Run `google_ads_health_check` as your first call. It verifies all four credentials, lists the accounts you can actually reach, and reports what is missing, without printing any secret.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": { "google-ads": { "command": "npx", "args": ["-y", "@getmcpads/google-ads-mcp-server"], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token", "GOOGLE_ADS_CLIENT_ID": "your-client-id", "GOOGLE_ADS_CLIENT_SECRET": "your-client-secret", "GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token", "GOOGLE_ADS_ACCOUNT_IDS": "123-456-7890" } } } }
Restart Claude Desktop. Ask it: *"list my Google Ads accounts"*.
claude mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=... --env GOOGLE_ADS_CLIENT_ID=... --env GOOGLE_ADS_CLIENT_SECRET=... --env GOOGLE_ADS_REFRESH_TOKEN=... -- npx -y @getmcpads/google-ads-mcp-server
.cursor/mcp.json in your project, same shape as the Claude Desktop config above.
git clone https://github.com/get-mcp-ads/google-ads-mcp-server.git
cd google-ads-mcp-server npm install && npm run build cp .env.example .env # then fill in your credentials npm start
| Variable | Default | Meaning |
|---|---|---|
GOOGLE_ADS_DEVELOPER_TOKEN | none | Required. From the API Center, Basic Access or above |
GOOGLE_ADS_CLIENT_ID | none | Required. OAuth client ID |
GOOGLE_ADS_CLIENT_SECRET | none | Required. OAuth client secret |
GOOGLE_ADS_REFRESH_TOKEN | none | Required. From the consent flow |
GOOGLE_ADS_LOGIN_CUSTOMER_ID | none | Optional. Manager (MCC) account ID. Resolved automatically when unset |
| GOOGLE_ADS_ACCOUNT_IDS | *unset* | Recommended. Comma-separated customer