Mcp Gads
by pijuszcommunityv0.5.4
1
The Google Ads MCP server allows users to query campaigns, keywords, assets, and more using natural language. It is built with Bun and TypeScript and is compatible with various MCP clients.
From the registry: Google Ads MCP server — query campaigns, keywords, assets & more via natural language
Install & configure
Prerequisites
- requiredGoogle Ads API developer tokenObtain a Google Ads API developer tokenhttps://developers.google.com/google-ads/api/docs/get-started/dev-token
- requiredOAuth client credentialsDownload OAuth client JSON from Google Cloud Console, then run 'npx mcp-gads setup' to complete OAuth and save a refresh token
https://console.cloud.google.com/apis/credentials$ npx mcp-gads setup
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `mcp-gads` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Google Ads API developer token** — Obtain a Google Ads API developer token (https://developers.google.com/google-ads/api/docs/get-started/dev-token)
- **OAuth client credentials** — Download OAuth client JSON from Google Cloud Console, then run 'npx mcp-gads setup' to complete OAuth and save a refresh token Run: `npx mcp-gads setup` (https://console.cloud.google.com/apis/credentials)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","mcp-gads@latest"]
- required environment variables:
- `GOOGLE_ADS_DEVELOPER_TOKEN`: Google Ads API developer token (example: `<your-developer-token>`)
- `GOOGLE_ADS_CREDENTIALS_PATH`: Path to OAuth client JSON file (example: `/path/to/credentials.json`)
- optional environment variables:
- `GOOGLE_ADS_CUSTOMER_ID`: Default customer ID (example: `<your-customer-id>`)
- `GOOGLE_ADS_LOGIN_CUSTOMER_ID`: MCC manager account ID (example: `<your-mcc-id>`)
- `GOOGLE_ADS_ENABLE_MUTATIONS`: Enable write tools (default false) (example: `false`)
- `GOOGLE_ADS_ENABLE_EXTENDED_TOOLS`: Enable extended read tools (default false) (example: `false`)
Note: Google Ads MCP server (39 tools). Requires Node 18+. Write tools and extended tools disabled by default — enable via env vars.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Google Ads MCP server (39 tools). Requires Node 18+. Write tools and extended tools disabled by default — enable via env vars.
Tools (23)
list_accounts
List all accessible Google Ads accounts
get_account_currency
Get the currency code for an account
get_account_hierarchy
Get MCC account tree (manager -> client)
execute_gaql_query
Run any GAQL query (table output)
run_gaql
Run GAQL with format options (table/json/csv)
get_gaql_help
GAQL reference guide with syntax, resources, and examples
list_resources
List valid GAQL FROM clause resources
get_campaign_performance
Campaign metrics (impressions, clicks, cost, conversions)
get_budget_utilization
Budget amounts vs actual spend
get_ad_performance
Ad-level performance metrics
get_ad_creatives
RSA headlines, descriptions, final URLs
get_image_assets
List image assets with URLs and dimensions
download_image_asset
Download a specific image asset to disk
get_asset_usage
Environment variables
GOOGLE_ADS_DEVELOPER_TOKENrequiredAPI developer tokenGOOGLE_ADS_CREDENTIALS_PATHrequiredPath to OAuth client JSONPrerequisites
- • Node 18+
Packages
mcp-gads
npmv0.5.4transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Mar 23, 2026
- Last commit
- Mar 23, 2026
- Registry name
- io.github.pijusz/mcp-gads
Categories
Related Servers
Twitter X Automation
Twitter X automation MCP - post schedule analytics engagement social media
198
Kesslerio Attio Mcp Server
Connect AI to your Attio CRM. Manage contacts, companies, deals, and sales pipelines. Create tasks…
63
Kesslerio Attio Mcp Server Beta
Streamline your Attio workflows using natural language to search, create, update, and organize com…
63