io.github.gudlab/ads-mcp MCP Server

io.github.gudlab/ads-mcp

Repository Registry

What is the io.github.gudlab/ads-mcp MCP server?

MCP server for Google Ads and Meta Ads. Wraps both APIs directly to manage campaigns.

How to install io.github.gudlab/ads-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GOOGLE_ADS_CLIENT_ID
required
secret
OAuth client ID from Google Cloud Console
GOOGLE_ADS_CLIENT_SECRET
required
secret
OAuth client secret from Google Cloud Console
GOOGLE_ADS_DEVELOPER_TOKEN
required
secret
Developer token from Google Ads API Center
GOOGLE_ADS_REFRESH_TOKEN
required
secret
Refresh token minted via `pnpm google:auth`
GOOGLE_ADS_CUSTOMER_ID
required
Default Google Ads account ID, 10 digits, no dashes
GOOGLE_ADS_LOGIN_CUSTOMER_ID
MCC account ID, only if the customer account is managed under one
META_APP_ID
required
Meta App ID from developers.facebook.com
META_APP_SECRET
required
secret
Meta App secret
META_ACCESS_TOKEN
required
secret
Long-lived System User access token with ads_management scope
META_AD_ACCOUNT_ID
required
Default Meta ad account ID, numeric, no act_ prefix

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "<YOUR_GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<YOUR_GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<YOUR_GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<YOUR_GOOGLE_ADS_CUSTOMER_ID>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<YOUR_GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
        "META_APP_ID": "<YOUR_META_APP_ID>",
        "META_APP_SECRET": "<YOUR_META_APP_SECRET>",
        "META_ACCESS_TOKEN": "<YOUR_META_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<YOUR_META_AD_ACCOUNT_ID>"
      }
    }
  }
}