Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Ads

Google Ads is Google's advertising platform for managing search, display, and shopping campaigns. Read campaign and search-term performance, review an account's conversion setup, and block wasted spend by adding negative keywords straight from the searches that triggered your ads.

  • MCP connection

Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

Connector
Authentication

Google Ads

OAuth sign-in

Google Ads (MCP)

MCP with OAuth

Google Ads

Connect to Google Ads to read campaign and search-term performance, review an account's conversion setup, and block wasted spend with negative keywords.

Set up in Google Ads

  1. Sign in to Google with an account that already has access to the Google Ads accounts you want to use.

  2. Approve the access Google asks for. The integration requests the AdWords scope, which covers reading campaign and search term data and writing negative keywords.

Set up in StackAI

  1. Open Settings → Connections, add a connection, and select Google Ads.

  2. Select Connect, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.

  3. Complete the fields marked for use after sign-in, such as the business or account selection.

  4. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

Connection fields

StackAI field
Required
What to enter

Manager Account ID

Optional / as applicable

Only needed when this Google Ads account is accessed through a manager (MCC) account: the manager's customer ID, digits only, no hyphens. Leave blank for a directly accessible account. Select this after signing in.

Provider documentation: Setup reference.

Google Ads (MCP)

Connect to a self-hosted deployment of Google's official read-only Google Ads MCP server for account discovery and GAQL reporting.

Set up in Google Ads

  1. Deploy Google’s google-ads-mcp server in an environment your StackAI deployment can reach. Google supplies the server software but does not provide a shared hosted endpoint for this connector.

  2. Configure the server’s Google Ads access and OAuth protection, then obtain its HTTPS /mcp endpoint.

Set up in StackAI

  1. Open Settings → Connections, add a connection, and select Google Ads (MCP).

  2. Complete the connector configuration below. If you do not have access to these settings, ask your StackAI administrator to configure the connector.

  3. Select Connect, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.

  4. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

Connector configuration

StackAI field
Required
What to enter

Server URL

Yes

The /mcp URL of your deployment of Google's official google-ads-mcp server. Google publishes the server, but does not host a shared endpoint.

Connection notes

  • Use the deployment’s MCP URL. A Google Ads account URL cannot be used as the server endpoint.

Provider documentation: Setup reference.

Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

Use an action

  1. Add the required Google Ads action to the workflow.

  2. Select a connection when the action requests one.

  3. Complete the required fields. Use the reference picker when a value comes from another workflow step.

  4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

Actions

List Ad Accounts

List the Google Ads accounts the connected login can reach.

Required permissions: https://www.googleapis.com/auth/adwords.

Inputs

Field
Type
Required
Description

Name Contains

string

No

Only return accounts whose name contains this text.

Outputs

Field
Type
Description

Accounts

array

Each account's ID, plus its name when the connection sets a manager account.

Account IDs

array

The 10-digit account IDs, in the same order as accounts.

Resource Names

array

The full API resource name for each account.

Total Count

integer

How many accounts matched, before the result was capped.

List Campaigns

List campaigns in an account, with their status and budget.

Required permissions: https://www.googleapis.com/auth/adwords.

Inputs

Field
Type
Required
Description

Ad Account

select (string)

Yes

The Google Ads account to read from. Options load from the selected connection.

Campaign Status

select (string)

No

Only return campaigns in this state. Available values: Enabled, Paused, Removed, All. Default: ALL.

Max Rows

integer

No

How many campaigns to return at most. Minimum: 1. Maximum: 1000. Default: 100.

Outputs

Field
Type
Description

Campaigns

array

The campaigns found.

More Available

boolean

Whether more rows exist beyond the ones returned.

Get Campaign Performance

Get spend and results per campaign over a date range.

Required permissions: https://www.googleapis.com/auth/adwords.

Inputs

Field
Type
Required
Description

Ad Account

select (string)

Yes

The Google Ads account to report on. Options load from the selected connection.

Date Range

select (string)

Yes

The period to report on. Available values: Today, Yesterday, Last 7 days, Last 30 days, This month, Last month, Custom. Default: LAST_7_DAYS.

Start Date

string

Yes

First day to include. Only used with a custom range. Default: .

End Date

string

Yes

Last day to include. Only used with a custom range. Default: .

Campaign Status

select (string)

No

Only report on campaigns in this state. Available values: Enabled, Paused, Removed, All. Default: ALL.

Max Rows

integer

No

How many campaign rows to return at most. Minimum: 1. Maximum: 1000. Default: 100.

Outputs

Field
Type
Description

Campaign Metrics

array

One row per campaign, with its metrics.

Totals

object

Summed metrics across the returned rows.

More Available

boolean

Whether more rows exist beyond the ones returned.

Get Search Terms Report

See the actual searches people typed that triggered your ads.

Required permissions: https://www.googleapis.com/auth/adwords.

Inputs

Field
Type
Required
Description

Ad Account

select (string)

Yes

The Google Ads account to report on. Options load from the selected connection.

Date Range

select (string)

Yes

The period to report on. Available values: Today, Yesterday, Last 7 days, Last 30 days, This month, Last month, Custom. Default: LAST_30_DAYS.

Start Date

string

Yes

First day to include. Only used with a custom range. Default: .

End Date

string

Yes

Last day to include. Only used with a custom range. Default: .

Campaign

select (string)

No

Only report on search terms from this campaign. Options load from the selected connection.

Max Rows

integer

No

How many search terms to return at most. Minimum: 1. Maximum: 1000. Default: 200.

Outputs

Field
Type
Description

Search Terms

array

One row per search term, with its metrics.

Totals

object

Summed metrics across the returned rows.

More Available

boolean

Whether more rows exist beyond the ones returned.

Add Negative Keywords

Block searches you do not want to pay for, across a whole campaign.

Required permissions: https://www.googleapis.com/auth/adwords.

Inputs

Field
Type
Required
Description

Ad Account

select (string)

Yes

The Google Ads account to change. Options load from the selected connection.

Campaign

select (string)

Yes

The campaign to add the negative keywords to. Options load from the selected connection.

Keywords to Block

array

Yes

The search terms to block.

Block As

select (string)

No

How closely a search has to match before it is blocked. Available values: Exact, Phrase, Broad. Default: PHRASE.

Outputs

Field
Type
Description

Added

array

The negative keywords that were created.

Not Added

array

Keywords that could not be added, and why.

Added Count

integer

How many negative keywords were created.

List Conversion Actions

List the conversion types set up in an account.

Required permissions: https://www.googleapis.com/auth/adwords.

Inputs

Field
Type
Required
Description

Ad Account

select (string)

Yes

The Google Ads account to read from. Options load from the selected connection.

Max Rows

integer

No

How many conversion actions to return at most. Minimum: 1. Maximum: 1000. Default: 100.

Outputs

Field
Type
Description

Conversion Actions

array

The conversion actions found.

More Available

boolean

Whether more rows exist beyond the ones returned.

Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.

Last updated

Was this helpful?