npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@renzo.johnson/google-ads-mcp

v26.11.15

Published

Google Ads MCP server for Claude Code, Cursor and any MCP client. Google Ads reporting, GAQL queries and campaign management. mcprush.com-3c5f87b9c75878a56ac7e87f

Readme

Google Ads MCP

Google Ads MCP server for Claude Code, Cursor and any MCP client. Google Ads reporting, GAQL queries and campaign management.

npx -y @renzo.johnson/google-ads-mcp

The server speaks MCP over stdio. It needs Node.js 22 or newer. Prefer VS Code? Install the Google Ads MCP extension: it signs you in with a wizard and registers the server with 8 AI agents.

Sign in

Google Ads needs a developer token and an OAuth user. Set these environment variables:

| Variable | Required | Value | |----------|----------|-------| | GOOGLE_ADS_DEVELOPER_TOKEN | yes | Your Google Ads API developer token | | GOOGLE_OAUTH_CLIENT_ID | yes | OAuth client ID (Desktop app) | | GOOGLE_OAUTH_CLIENT_SECRET | yes | OAuth client secret | | GOOGLE_OAUTH_REFRESH_TOKEN | yes | A refresh token granted the https://www.googleapis.com/auth/adwords scope | | GOOGLE_ADS_LOGIN_CUSTOMER_ID | for manager accounts | Manager (MCC) account ID, digits only | | GOOGLE_ADS_DEFAULT_CUSTOMER_ID | no | Account used when a tool call names none |

GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET and GOOGLE_ADS_REFRESH_TOKEN also work and take precedence.

Claude Code

Add it from the command line:

claude mcp add google-ads -- npx -y @renzo.johnson/google-ads-mcp

Or add it to .mcp.json in your project (or ~/.claude.json for every project).

Cursor

Add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

Configuration

Claude Code and Cursor use the same JSON shape:

With your Google Ads credentials:

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token",
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "your-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Available Tools (14)

Read Tools (10)

| Tool | What It Does | Example Prompt | |------|-------------|----------------| | ping | Check server connectivity | "Ping the Google Ads MCP server" | | ads_list_accounts | List accessible customer accounts | "Show me all my Google Ads accounts" | | ads_account_info | Account details (name, currency, timezone) | "What timezone is my Ads account set to?" | | ads_campaigns | List campaigns with metrics | "Show me all active campaigns and their performance" | | ads_ad_groups | List ad groups with metrics | "Show ad groups for campaign 123456" | | ads_ads | List ads with headlines and descriptions | "Show me the ads in my brand campaign" | | ads_keywords | Keyword performance report | "What are my top 20 keywords by clicks?" | | ads_search_terms | Search terms report | "What are users actually searching to find my ads?" | | ads_performance | Account/campaign performance summary | "Show me account performance for March 2026" | | ads_query | Run arbitrary GAQL queries (read-only) | "Run a GAQL query for campaign metrics by device" |

Admin Mega-Tools (4)

All admin actions require confirm: true because they affect real ad spend.

Campaign Admin

| Action | Description | |--------|-------------| | create_campaign | Create a new search campaign (starts paused) | | update_campaign | Update campaign name | | pause_campaign | Pause a campaign | | enable_campaign | Enable a paused campaign | | remove_campaign | Remove a campaign | | update_budget | Change daily budget |

Ad Group Admin

| Action | Description | |--------|-------------| | create_ad_group | Create a new ad group (starts paused) | | update_ad_group | Update name or CPC bid | | pause_ad_group | Pause an ad group | | enable_ad_group | Enable a paused ad group | | remove_ad_group | Remove an ad group |

Ad Admin

| Action | Description | |--------|-------------| | create_responsive_search_ad | Create a responsive search ad (starts paused) | | pause_ad | Pause an ad | | enable_ad | Enable a paused ad | | remove_ad | Remove an ad |

Keyword Admin

| Action | Description | |--------|-------------| | add_keywords | Add keywords to an ad group | | pause_keyword | Pause a keyword | | enable_keyword | Enable a paused keyword | | remove_keyword | Remove a keyword | | update_bid | Change keyword CPC bid |

Safety

Every write action requires explicit confirmation. Unlike other Google MCP extensions where only destructive actions need confirmation, Google Ads MCP requires confirm: true for ALL admin actions -- because every action affects real advertising spend.

New campaigns, ad groups, and ads are always created in a paused state to prevent accidental spend.

Privacy

The server sends no telemetry. It talks only to Google APIs, with your own credentials.

Links

By Renzo Johnson | MIT License