Google Ads MCP Server for Claude and Cursor

Hosted Google Ads MCP for Claude, Cursor, and ChatGPT. Monitor campaigns, update ad groups, and pull performance reports with managed OAuth.

Get started for free Get a demo

Google Ads

Oauth2

Google Ads is Google's online advertising platform for creating, managing, and optimizing digital campaigns. It helps businesses reach targeted customers and maximize return on ad spend.

36 Tools

Try Google Ads now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND

Google Ads

Enter ↵

Try asking

TOOLS

Supported Tools

Every Google Ads action and event your agent gets out of the box.

Add or remove to customer list

Adds or removes contacts from a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account.

Batch Mutate Google Ads Resources

Create, update, remove, or act on supported Google Ads resource types in one request.

Create Callout Asset

Create an immutable account asset containing a validated callout.

Create customer list

Creates a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account.

Get Campaign By Id

GetCampaignById Tool returns details of a campaign in Google Ads.

Get campaign by name

Queries Google Ads via SQL to retrieve a campaign by its exact name.

Get Conversion Action Tag Snippets

Retrieve provider-generated website or call conversion tag snippets after creating a conversion action.

Get conversion ingestion status

Retrieve one Data Manager ingestion status snapshot.

Get customer lists

GetCustomerLists Tool lists all customer lists (audience/remarketing lists) in Google Ads.

Get Required Google Ads Report

Run a prominent, bounded Google Ads report template for Customer, Campaign, Ad, Keyword, Search Term, Dynamic Search Ads Search Term, or Bidding Strategy.

Ingest conversion events

Validate or submit a bounded Google Ads conversion-event batch.

List Accessible Customers

List Google Ads customer resource names directly accessible to the authenticated OAuth user.

List data manager conversion actions

List conversion actions usable as Google Ads Data Manager destinations.

List Sub Accounts

List direct child/sub-accounts under a Google Ads manager (MCC) account.

Mutate Ad Group Ads

Create, update, or remove ads in Google Ads ad groups, including responsive search ads.

Mutate Ad Group Assets

Create, update, or remove links between assets and ad groups.

Mutate Ad Group Bid Modifiers

Create, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.

Mutate Ad Group Criteria

Create, update, or remove criteria attached to a Google Ads ad group in a single batch request.

Mutate Ad Groups

Create, update, or remove ad groups within Google Ads campaigns.

Mutate Assets

Create or update supported Google Ads assets such as sitelinks, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets.

Mutate Asset Sets

Create, update, or remove Google Ads asset sets, which group assets for feeds, locations, and other campaign uses.

Mutate Bidding Strategies

Create, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion Value, and Target Impression Share.

Mutate Campaign Assets

Create, update, or remove links between assets and campaigns.

Mutate Campaign Budgets

Create, update, or remove Google Ads campaign budgets.

Mutate Campaign Criteria

Create, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules, audiences, and IP exclusions.

Mutate Campaign Labels

Create or remove relationships between campaigns and labels.

Mutate Campaigns

Create, update, or remove Google Ads campaigns in batch.

Mutate Campaigns V2

Create, update, or remove Google Ads campaigns in batch.

Mutate Conversion Actions

Create, update, or remove Google Ads conversion actions for conversion tracking configuration.

Mutate Custom Audiences

Create, update, or remove Google Ads custom audiences used to reach users by interests, searches, visited URLs, place categories, or installed apps.

Mutate Customer Assets

Create or remove customer-level asset associations.

Mutate Labels

Create, update, or remove Google Ads labels.

Mutate Portfolio Bidding Strategies

Create, edit, or remove typed Target CPA and Target ROAS portfolio strategies.

Mutate Shared Sets

Create, update, or remove Google Ads shared sets used to group shared criteria, such as negative keyword lists, for reuse across campaigns.

Search Google Ads Fields

Search the Google Ads v23 field metadata catalog with GAQL.

Search Stream GAQL

Execute a Google Ads Query Language (GAQL) query and aggregate every streamed response batch in order.

SETUP GUIDE

Connect Google Ads MCP Tool with your Agent

Install Composio

typescript

npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai

Install the Composio SDK and your agent framework

Create a session with MCP enabled

typescript

import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["googleads"],
  mcp: true,
});

Create a session scoped to Google Ads and read its MCP URL and headers

Connect your agent to the MCP server

typescript

import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all customer lists for my ad account",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();

Pass the session's MCP URL and headers to your agent and run a Google Ads request

SETUP GUIDE

Connect Google Ads API Tool with your Agent

Install Composio

typescript

npm install @composio/core @composio/openai openai

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK

Create a Composio session

typescript

import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["googleads"] });
const tools = await session.tools();

Initialize Composio with the OpenAI Responses provider and create a session scoped to Google Ads

Run Google Ads tools with your agent

typescript

let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all customer lists for my ad account" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);

Send a request, execute the Google Ads tool calls through the session, and print the final answer

Guide

Connect multiple Google Ads accounts to Claude and tell it which one to use by name.

Read the guide

Why Use Composio?

AI Native Google Ads Integration

Supports both Google Ads MCP and direct API based integrations
Structured, LLM-friendly schemas for reliable tool execution
Rich coverage for reading, writing, and querying your Google Ads data

Managed Auth

Built-in OAuth handling with automatic token refresh and rotation
Central place to manage, scope, and revoke Google Ads access
Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

Tools are tuned using real error and success rates to improve reliability over time
Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

Fine-grained RBAC so you control which agents and users can access Google Ads
Scoped, least privilege access to Google Ads resources
Full audit trail of agent actions to support review and compliance

FRAMEWORKS

Use Google Ads with any AI Agent Framework

Choose a Framework you want to connect Google Ads with

OpenAI Agents SDK

Use Google Ads MCP with OpenAI Agents SDK

Claude Agents SDK

Use Google Ads MCP with Claude Agents SDK

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Metaads

Oauth2Api Key

Metaads is Meta's official Ads API that lets you manage, analyze, and optimize your Facebook and Instagram ad campaigns. Streamline ad operations and gain deeper insights with robust automation.

Adrapid

Api Key

Adrapid is a platform for rapid creation of digital marketing visuals using templates. It streamlines design workflows for banners, images, and HTML5 content with automation.

AdRoll

Oauth2

AdRoll is a digital marketing platform for managing advertising campaigns, audiences, and account-based marketing. It helps marketers retarget customers across channels and measure performance.

Adtraction

Api Key

Adtraction is an affiliate marketing platform for partner programs, tracking links, transactions, commissions, statistics, and payments. It helps advertisers and publishers manage performance marketing with clear reporting and payout workflows.

FAQ

Frequently asked questions

No. Composio provides a managed OAuth app for Google Ads, so you sign in with your normal Google Ads account and approve access. If you later want the consent screen to show your own company name, you can add your own Google Ads OAuth app in the Composio dashboard, and every connection after that uses it.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Google Ads connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Google Ads account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Google Ads as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Google Ads lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Google Ads administrator may need to approve the app first, and you can revoke the access inside Google Ads whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Google Ads connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Google Ads tokens automatically, so day to day you do nothing. If you revoke access inside Google Ads, or Google Ads invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, and up to 20,000 of those can run through Composio-managed apps like Google Ads. Personal Google Ads use rarely gets near that. Paid plans add higher limits and team features, and Google Ads's own pricing is unaffected.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Google Ads accounts).

With Composio, you connect Google Ads once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Google Ads.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Ads tool your agent needs.Free to start.

Start building

Google Ads MCP Server for Claude and Cursor

Try Google Ads now

Supported Tools

Connect Google Ads MCP Tool with your Agent

Install Composio

Create a session with MCP enabled

Connect your agent to the MCP server

Connect Google Ads API Tool with your Agent

Install Composio

Create a Composio session

Run Google Ads tools with your agent

Why Use Composio?

AI Native Google Ads Integration

Managed Auth

Agent Optimized Design

Enterprise Grade Security

Use Google Ads with any AI Agent Framework

Claude Code

Cursor

ChatGPT

Claude Cowork

Antigravity

OpenAI Agents SDK

Claude Agents SDK

Grok Bot

Codex

Kimi Code

Grok Build

VS Code

OpenCode

OpenClaw

Hermes

Atomic Agent

CLI

Google ADK

Langchain

AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

Autogen

Rolling this out across your team?

Explore Other Toolkits

Metaads

Adrapid

AdRoll

Adtraction

Frequently asked questions

Do I need my own Google Ads developer credentials or OAuth app?+

Can I use multiple toolkits together?+

Is Composio secure with my Google Ads account?+

What if the API changes?+

Does the agent act as me inside Google Ads?+

Which Google Ads permissions does Composio get?+

Can I use multiple Google Ads accounts with Claude and ChatGPT?+

What happens when my Google Ads access expires or I revoke it?+

Does using Google Ads through Composio cost extra?+

How is Composio different from the Google Ads connectors already built into Claude and ChatGPT?+

Start with Google Ads.It takes 30 seconds.