`gads_list_campaigns`

Pack: google_ads · Endpoint: https://gateway.pipeworx.io/google_ads/mcp

List all campaigns in your Google Ads account. Returns campaign names, IDs, statuses, budgets, and types. Use to overview account structure or find a campaign ID for detailed analysis.

Parameters

Name	Type	Required	Description
`customer_id`	string	yes	Google Ads customer ID (e.g., “1234567890” or “123-456-7890”)
`status`	string	no	Filter by campaign status (optional, returns all if omitted)
`limit`	number	no	Maximum number of campaigns to return (default 50)

Example call

Arguments

{
  "customer_id": "1234567890"
}

curl

curl -X POST https://gateway.pipeworx.io/google_ads/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gads_list_campaigns","arguments":{"customer_id":"1234567890"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('gads_list_campaigns', {
  "customer_id": "1234567890"
});

More examples

{
  "customer_id": "123-456-7890",
  "status": "ENABLED",
  "limit": 25
}

Response shape

Field	Type	Description
`results`	array	List of campaigns from GAQL search results

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "List of campaigns from GAQL search results",
      "items": {
        "type": "object",
        "properties": {
          "campaign": {
            "type": "object",
            "description": "Campaign resource data",
            "properties": {
              "id": {
                "type": "string",
                "description": "Campaign ID"
              },
              "name": {
                "type": "string",
                "description": "Campaign name"
              },
              "status": {
                "type": "string",
                "description": "Campaign status (ENABLED, PAUSED, REMOVED)"
              },
              "advertising_channel_type": {
                "type": "string",
                "description": "Advertising channel type"
              },
              "bidding_strategy_type": {
                "type": "string",
                "description": "Bidding strategy type"
              }
            }
          },
          "campaign_budget": {
            "type": "object",
            "description": "Campaign budget information",
            "properties": {
              "amount_micros": {
                "type": "number",
                "description": "Budget amount in micros"
              }
            }
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "google_ads": {
      "url": "https://gateway.pipeworx.io/google_ads/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

gads_list_campaigns