integrateintegrate

View as Markdown

Google Ads Integration

Manage Google Ads customers, campaigns, ad groups, ads, keywords, and conversions

The Google Ads integration provides access to manage Google Ads customers, campaigns, ad groups, ads, keywords, and conversions through the Integrate MCP server.

Installation

The Google Ads integration is included with the SDK:

import { googleAdsIntegration } from "integrate-sdk/server";

Setup

1. Create a Google Ads OAuth App

  1. Go to Google Cloud Console
  2. Create a new OAuth application
  3. Configure your redirect URI
  4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Google Ads integration to your server configuration. The integration automatically reads GOOGLE_ADS_CLIENT_ID and GOOGLE_ADS_CLIENT_SECRET from your environment variables:

import { createMCPServer, googleAdsIntegration } from "integrate-sdk/server";
 
export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    googleAdsIntegration({
      scopes: ["https://www.googleapis.com/auth/adwords"], // Optional
    }),
  ],
});

You can override the environment variables by passing explicit values:

googleAdsIntegration({
  clientId: process.env.CUSTOM_GOOGLE_ADS_ID,
  clientSecret: process.env.CUSTOM_GOOGLE_ADS_SECRET,
      scopes: ["https://www.googleapis.com/auth/adwords"], // Optional
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";
 
await client.authorize("google_ads");
const result = await client.google_ads.listAccessibleCustomers({});
 
console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, googleAdsIntegration } from "integrate-sdk";
 
const customClient = createMCPClient({
  integrations: [googleAdsIntegration()],
});

Configuration Options

export interface GoogleAdsIntegrationConfig {
  clientId?: string;

Default Scopes

These defaults are applied unless you override scopes in the integration config:

  • https://www.googleapis.com/auth/adwords

Tools

Ads list accessible customers

No parameters.

Ads search

export interface GoogleAdsSearchParams { customer_id: string;

Ads list campaigns

export interface GoogleAdsListCampaignsParams { customer_id: string;

Ads list ad groups

export interface GoogleAdsListAdGroupsParams { customer_id: string;

Ads list ads

export interface GoogleAdsListAdsParams { customer_id: string;

Ads list keywords

export interface GoogleAdsListKeywordsParams { customer_id: string;

Ads list conversions

export interface GoogleAdsListConversionsParams { customer_id: string;

Notes

  • Category: Marketing
  • Authentication mode: OAuth