Gudlab Ads

Name: Gudlab Ads MCP Server
Author: gudlab

stdio

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

Getting Started

npx @getmcp/cli add io.github.gudlab/ads-mcp

Requires Node.js 18+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

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

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.gudlab/ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "",
        "GOOGLE_ADS_CLIENT_SECRET": "",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "",
        "GOOGLE_ADS_REFRESH_TOKEN": "",
        "GOOGLE_ADS_CUSTOMER_ID": "",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "",
        "META_APP_ID": "",
        "META_APP_SECRET": "",
        "META_ACCESS_TOKEN": "",
        "META_AD_ACCOUNT_ID": ""
      }
    }
  }
}

Claude Desktop MCP documentation