`gads_list_campaigns`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/gads_list_campaigns for the schema, then POST the same URL with its arguments for the data.

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