adwarp

Start with 1 prompt

Paste it into Claude Code, Codex or Cursor. Your agent installs Adwarp, walks you through your LinkedIn app and checks the connection.

setup prompt
Set up Adwarp for me. It's the open-source ad agent for LinkedIn Ads and Google Ads: https://github.com/adwarp-dev/adwarp

1. Check that Node.js 20 or newer is installed.
2. Walk me through creating my own LinkedIn developer app with the Advertising API product: https://github.com/adwarp-dev/adwarp/blob/main/docs/linkedin-app.md
3. Save the app's client ID and secret to ~/.adwarp/config.json as clientId and clientSecret.
4. Run "npx -y adwarp auth login" and wait while I approve access in my browser.
5. Add Adwarp to the AI client I'm using right now as an MCP server that runs "npx -y adwarp mcp". In Claude Code that's: claude mcp add adwarp -- npx -y adwarp mcp
6. Check the connection by listing my ad accounts, then save the one I pick as defaultAccountId in ~/.adwarp/config.json.

Don't create or change anything in my ad accounts during setup. LinkedIn campaigns start as drafts, so nothing spends until I turn it on.
adwarp
GitHub

Start with 1 prompt

Paste it into Claude Code, Codex or Cursor. Your agent installs Adwarp, walks you through your LinkedIn app and checks the connection.

setup prompt
Set up Adwarp for me. It's the open-source ad agent for LinkedIn Ads and Google Ads: https://github.com/adwarp-dev/adwarp

1. Check that Node.js 20 or newer is installed.
2. Walk me through creating my own LinkedIn developer app with the Advertising API product: https://github.com/adwarp-dev/adwarp/blob/main/docs/linkedin-app.md
3. Save the app's client ID and secret to ~/.adwarp/config.json as clientId and clientSecret.
4. Run "npx -y adwarp auth login" and wait while I approve access in my browser.
5. Add Adwarp to the AI client I'm using right now as an MCP server that runs "npx -y adwarp mcp". In Claude Code that's: claude mcp add adwarp -- npx -y adwarp mcp
6. Check the connection by listing my ad accounts, then save the one I pick as defaultAccountId in ~/.adwarp/config.json.

Don't create or change anything in my ad accounts during setup. LinkedIn campaigns start as drafts, so nothing spends until I turn it on.

Google Ads in Gemini

Adwarp is an open-source MCP server and CLI that connects Gemini in your terminal, Google's Antigravity CLI, to Google Ads. Add it with 1 command, then ask Gemini to research keywords, build paused Search campaigns and pull reports.

$ agy mcp add adwarp npx -y adwarp mcp

Read the docs

agy ~ build

$ agy

> Build a Search campaign for expense management at 40 USD a day.

adwarp.gads_launch_search_campaign dry run, 40 USD/day: valid

Validated by Google. Nothing was created yet.

Confirm and it's created paused. You switch it on in Google Ads.

01Set up

Set up in 3 steps

  1. Get Google Ads API access

    A developer token from your Google Ads manager account, plus a Desktop app OAuth client in Google Cloud.

  2. Sign in from your terminal

    Add both to ~/.adwarp/google.json, and Adwarp opens your browser for Google's approval.

    npx -y adwarp google auth login
  3. Add it to Antigravity CLI

    1 command, and Gemini can use all 9 Google Ads tools on your machine.

    agy mcp add adwarp npx -y adwarp mcp
Prefer to edit the config?

agy mcp add writes this entry to ~/.gemini/config/mcp_config.json. Put it in .agents/mcp_config.json instead to add it to 1 project, and type /mcp in agy to check that adwarp is connected. On Gemini CLI, run gemini mcp add -s user adwarp npx -y adwarp mcp instead.

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "adwarp": { "command": "npx", "args": ["-y", "adwarp", "mcp"] }
  }
}

02Try these prompts

5 prompts to try first

agy ~ keywords

$ agy

> Find keyword ideas for expense management software in the US.

adwarp.gads_keyword_ideas "expense management software", US: 50 ideas

Monthly searches, competition and top-of-page bid range for each

03Results

Why running Google Ads from Gemini gets better results

  • Every write checked first

    Google validates the whole build in a dry run before anything is created.

  • Waste gets caught early

    Search terms and keyword costs are 1 question away, so you check them weekly instead of at month end.

  • Both platforms in 1 session

    The same local server runs the Google Ads and LinkedIn tools, so 1 question compares them.

04FAQ

Questions, answered From setup to the details.

Ask on GitHub
Does Adwarp work with Gemini for Google Ads?

Yes. Add it to Antigravity CLI or Gemini CLI, and Gemini gets all 9 Google Ads tools, running on your machine.

Does it work in Gemini CLI?

Yes. Run gemini mcp add -s user adwarp npx -y adwarp mcp, which writes the same entry to ~/.gemini/settings.json. Antigravity CLI replaced Gemini CLI for individual accounts on June 18, 2026.

Does it work in the Gemini app?

Not yet. The Gemini app adds remote MCP servers that sign in with OAuth, which the hosted endpoint doesn't support yet.

Can Gemini enable a campaign?

No. Adwarp creates Google campaigns paused and has no way to enable them. You switch them on in Google Ads.

Is there an official Google Ads MCP server?

Yes, and it's read-only. Adwarp is independent and open source, and it also researches keywords and builds paused Search campaigns.

Does it work with the hosted endpoint?

Not for Google Ads. The hosted endpoint serves many callers, and Google credentials there would come from shared server settings, so it never registers the Google tools. Run Adwarp on your machine with your own developer token and OAuth client.

What access do I need?

A Google Ads developer token from a manager account and a Desktop app OAuth client. Campaigns and reporting work on Explorer access, and keyword research needs Basic access.

  • A developer token from the API Center of a Google Ads manager account. A plain client account can't issue one.
  • Explorer access arrives automatically and covers campaigns and reporting. Keyword research needs Basic access, a separate application on the same screen.
  • An OAuth client of the Desktop app type, in a Google Cloud project with the Google Ads API enabled.
  • A consent screen that isn't left in Testing, which issues sign-ins that stop working after 7 days.
What goes in google.json?

Your OAuth client, developer token and account ids, kept on your machine.

loginCustomerId is your manager account, needed only when you reach the ad account through one. Then run npx -y adwarp google auth login.

~/.adwarp/google.json
{
  "clientId": "....apps.googleusercontent.com",
  "clientSecret": "...",
  "developerToken": "...",
  "loginCustomerId": "1234567890",
  "defaultCustomerId": "0987654321",
  "defaultConversionActionNames": ["Demo Booked"]
}
Which Google Ads tools does it add?

9 tools, all running on your machine.

Which Google Ads tools does it add?
ToolWhat it does
gads_list_accountsEvery Google Ads customer your login can reach. Run it first to prove the setup works.
gads_list_client_accountsThe client accounts under a manager account.
gads_keyword_ideasSearch volume, competition and top-of-page bid range for seed terms or a landing page.
gads_list_campaignsCampaigns with their ad groups, paused ones included.
gads_list_adsThe ads in an ad group, with their responsive search copy.
gads_list_conversion_actionsConversion actions on the account, so a launch can name 1.
gads_launch_search_campaignA paused Search campaign from a brief, in 1 atomic change, validated by Google first.
gads_performanceRows at campaign, ad group, ad, keyword or search term level.
gads_searchA raw, read-only GAQL query.
Which house rules does every campaign follow?

Search network only, people in your target area, manual CPC to start, and created paused.

  • Search network only. Display expansion and search partners are off.
  • People physically in your target area. US means people in the US, not anyone who searched about it.
  • Manual CPC to start. Switch to smart bidding in Google Ads once there's conversion data.
  • Created paused, with no tool to enable it. You switch it on in Google Ads.
  • Search campaigns only for now. No Performance Max, Display, Shopping, video or Customer Match yet.