What You'll Set Up

By the end of this guide, your AI agent will be able to interact with your Google Ads account — viewing campaign performance, checking keyword metrics, managing budgets, and pulling reports on ad spend. The setup takes about ten minutes, most of which is spent getting your Developer Token from Google.

Once connected, your agent can answer questions like "How are my campaigns performing this week?" or "What keywords are driving the most conversions?" using live data from your ad account.

Google Ads

11 tools · Let AI agents manage your ad spend

Before You Begin

Make sure you have:

A Google Ads account — Create one at ads.google.com if you don't have one
A Google Ads Developer Token — Required for API access (see Step 1 below)
A Pipeworks workspace — Sign up at pipeworks.ai if you haven't already

Warning

Google Ads requires a Developer Token to use the API. You need to apply for one through the Google Ads API Center. Basic access tokens work for most use cases, but approval can take a few days.

Steps

Get your Google Ads Developer Token

Log into your Google Ads account. Click the Tools icon in the top navigation, then go to Setup > API Center. If you do not see the API Center option, you may need to request access first.

In the API Center, you will find your Developer Token. If you have not applied for one yet, click Apply for access and follow the prompts. Basic access is usually sufficient and allows up to 15,000 operations per day.

Copy your Developer Token — you will need it in a later step.

Note your Google Ads Customer ID

Your Customer ID is the 10-digit number shown at the top of your Google Ads dashboard (formatted as XXX-XXX-XXXX). If you manage multiple accounts through a manager account, note the Customer ID of the specific account you want your agent to access.

Open your Pipeworks console

Log into your Pipeworks workspace and go to the Integrations page. Find Google Ads in the list and click on it.

Sign in with Google and enter your credentials

Click Connect with Google. You will be redirected to Google's sign-in page. Choose the Google account associated with your Google Ads account and grant the requested permissions.

After signing in, enter your Developer Token and Customer ID in the credential fields. Click Connect to save.

Pipeworks encrypts all credentials with AES-256-GCM before storing them. Your Developer Token and account details are never saved in plaintext.

Start the integration

Click Start to launch the Google Ads integration container. This takes a few seconds. Once the status shows Running, your agent is ready to work with your ad campaigns.

Test the connection

Use the Test button to verify everything works. This sends a request to the Google Ads API to confirm your credentials are valid and your account is accessible.

What Your Agent Can Do

Once connected, your AI agent has access to Google Ads tools for:

Campaigns — View all campaigns, check status, and monitor performance metrics
Performance reports — Pull data on impressions, clicks, conversions, cost, and return on ad spend
Budgets — View and manage campaign budgets and bidding strategies
Keywords — Research keyword performance, check quality scores, and review search terms
Ad groups — View ad group structure and performance breakdowns

Tip

Use tool profiles to control what your agent can do. Set the profile to read-only if you want your agent to report on campaign performance without making any changes to budgets or settings.

Connecting from Your AI Agent

Add the Pipeworks tools endpoint to your agent's configuration. Here's an example for Claude Desktop:

json

{
  "mcpServers": {
    "pipeworks-google-ads": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.pipeworks.ai/tools/google-ads"]
    }
  }
}

Claude Desktop will prompt you to sign in through Pipeworks when you first connect. No access key needed.

Troubleshooting

Developer Token not approved yet? Google Ads API access requires approval, which can take a few business days. Check the status in your Google Ads API Center. A test account Developer Token works immediately if you want to try things out first.

Wrong Customer ID? Make sure you are using the Customer ID for the specific account (not a manager account) you want to query. The ID is the 10-digit number at the top of the Google Ads dashboard.

Connection test fails? Verify that your Developer Token is active and that the Google account you signed in with has access to the Google Ads account matching your Customer ID.

Agent can't find tools? Verify your Pipeworks session is authenticated and that the integration status shows "Running" in your Pipeworks console.

Connect Google Ads to Pipeworks

Prerequisites