# Adwarp

> Adwarp is a free, open-source ad agent that runs in your terminal. Size audiences, draft campaigns and pull reports on LinkedIn Ads and Google Ads.

- Open source under the MIT license. No paid plan, no account and no sign-up.
- Runs from your terminal as an MCP server in Claude, Codex, Cursor, Gemini (Antigravity CLI or Gemini CLI) or other MCP clients that can run a local server, and as a CLI.
- LinkedIn Ads also works in Meta Muse and xAI's Grok Bot, which add your own Adwarp endpoint on Vercel with 1 bearer token.
- Install the MCP server with `npx -y adwarp mcp`, or run the CLI with `npx adwarp`.
- 37 tools for LinkedIn Ads and Google Ads: audience sizing, matched audiences (including from Salesforce and HubSpot), campaigns and ads, reporting, LinkedIn Ad Library research and a change journal with lift analysis.
- Nothing spends until you turn it on. LinkedIn campaigns are created as drafts and Google campaigns as paused.
- Connects through LinkedIn and Google Ads developer apps you create and control. Credentials stay on your machine, and the hosted endpoint uses them in memory per request and never stores them.
- Not affiliated with or endorsed by LinkedIn or Google.

## Pages

- [Open-source ad agent for LinkedIn and Google Ads | Adwarp](https://adwarp.dev/index.md): Adwarp is a free, open-source ad agent that runs in your terminal. Size audiences, draft campaigns and pull reports on LinkedIn Ads and Google Ads.
- [LinkedIn Ads MCP server and CLI, open source | Adwarp](https://adwarp.dev/linkedin-ads.md): Run LinkedIn Ads from your terminal with Adwarp, a free open-source MCP server and CLI. Size audiences, draft campaigns, read competitor ads and pull reports.
- [LinkedIn Ads management from your terminal | Adwarp](https://adwarp.dev/linkedin-ads/campaigns.md): Manage LinkedIn campaigns from your terminal. Adwarp turns a plain-words brief into campaign groups, ad groups and ads with budgets and schedules, as drafts.
- [LinkedIn Ads reporting from your terminal | Adwarp](https://adwarp.dev/linkedin-ads/reporting.md): Ask how your LinkedIn ads are doing from your terminal: spend, click-through rate and cost per conversion by campaign or ad, and a scheduled weekly report.
- [LinkedIn Ad Library search from your terminal | Adwarp](https://adwarp.dev/linkedin-ads/ad-library.md): Search the LinkedIn Ad Library from your terminal with Adwarp, an open-source CLI and MCP server. Pull any company's ads, ready to sort, compare and summarize.
- [LinkedIn Ads optimization from your terminal | Adwarp](https://adwarp.dev/linkedin-ads/optimization.md): Pause rules, budget pacing, bid changes and A/B tests for LinkedIn Ads from your terminal, with every change journaled so you can measure the lift.
- [LinkedIn retargeting from your terminal | Adwarp](https://adwarp.dev/linkedin-ads/retargeting.md): Run LinkedIn retargeting from your terminal: target website, video and engagement audiences, rotate fresh creative and keep converted accounts out.
- [LinkedIn account-based marketing from your terminal | Adwarp](https://adwarp.dev/linkedin-ads/abm.md): Run 1:1 account-based LinkedIn ads from your terminal: an audience per target account, sized to its decision makers, with its own ads and flight.
- [LinkedIn matched audiences from your terminal | Adwarp](https://adwarp.dev/linkedin-ads/audiences.md): Size LinkedIn audiences and upload contact or company lists from your terminal. Adwarp cleans and hashes the CSV and checks the size before you spend.
- [Integrations: Salesforce, HubSpot, LinkedIn, Google | Adwarp](https://adwarp.dev/integrations.md): Adwarp is an open-source MCP server and CLI that runs LinkedIn Ads and Google Ads from your terminal, with Salesforce and HubSpot as audience sources.
- [LinkedIn Ads and Salesforce from your terminal | Adwarp](https://adwarp.dev/integrations/salesforce.md): Turn a Salesforce query into a LinkedIn matched audience from your terminal. Adwarp hashes the emails on your machine, and there's no export step.
- [HubSpot LinkedIn Ads integration from your terminal | Adwarp](https://adwarp.dev/integrations/hubspot.md): Build HubSpot to LinkedIn matched audiences from your terminal. Adwarp reads a list or CRM search with a read-only token and uploads only hashed emails.
- [Google Ads MCP server and CLI, open source | Adwarp](https://adwarp.dev/google-ads.md): Run Google Ads from your terminal with Adwarp, a free open-source MCP server and CLI. Research keywords and draft Search campaigns that always start paused.
- [Google Ads Search campaigns from your terminal | Adwarp](https://adwarp.dev/google-ads/search-campaigns.md): Build paused Google Ads Search campaigns from a brief with Adwarp, an open-source MCP server and CLI. Google validates every launch in a dry run first.
- [Google Ads keyword research from your terminal | Adwarp](https://adwarp.dev/google-ads/keyword-research.md): Research Google Ads keywords from your terminal with Adwarp: monthly searches, competition and top-of-page bid ranges for seed terms or a landing page.
- [Google Ads reporting from your terminal | Adwarp](https://adwarp.dev/google-ads/reporting.md): Pull Google Ads performance from your terminal with Adwarp: spend, clicks and conversions by campaign, ad group, ad, keyword or search term, plus raw GAQL.
- [How it works: MCP server and CLI for ads | Adwarp](https://adwarp.dev/how-it-works.md): Adwarp runs 2 ways from your terminal: as an MCP server inside Claude, Codex or Cursor, or as a CLI you can script and schedule. Both are open source.
- [Pricing: free and open source | Adwarp](https://adwarp.dev/pricing.md): Adwarp is free and open source under the MIT license. The CLI, the MCP server and the hosted endpoint cost 0 USD. You only pay for the ads you run.
- [Changelog | Adwarp](https://adwarp.dev/changelog.md): Every Adwarp release, newest first: what changed in the free, open-source MCP server and CLI for LinkedIn Ads and Google Ads that runs from your terminal.
- [LinkedIn Ads in Claude: connect it with MCP | Adwarp](https://adwarp.dev/linkedin-ads/claude.md): Connect LinkedIn Ads to Claude Code or Claude Desktop with Adwarp, a free open-source MCP server. Set up from your terminal, then manage campaigns by asking.
- [LinkedIn Ads in Codex | Adwarp](https://adwarp.dev/linkedin-ads/codex.md): Connect LinkedIn Ads to OpenAI Codex with Adwarp, a free open-source MCP server. Add it from your terminal, then size audiences and draft campaigns by asking.
- [LinkedIn Ads in Cursor | Adwarp](https://adwarp.dev/linkedin-ads/cursor.md): Connect LinkedIn Ads to Cursor with Adwarp, a free open-source MCP server and CLI. Set up from your terminal, then size audiences and draft campaigns by asking.
- [LinkedIn Ads CLI, open source | Adwarp](https://adwarp.dev/linkedin-ads/cli.md): Run LinkedIn Ads from the command line with Adwarp, a free open-source CLI and MCP server. Size audiences, launch drafts from a brief and schedule reports.
- [LinkedIn Ads in Gemini: connect it with MCP | Adwarp](https://adwarp.dev/linkedin-ads/gemini.md): Connect LinkedIn Ads to Gemini with Adwarp, a free open-source MCP server. Add it to Antigravity CLI or Gemini CLI, then size audiences and draft campaigns.
- [LinkedIn Ads in Meta Muse: connect it with MCP | Adwarp](https://adwarp.dev/linkedin-ads/muse.md): Connect LinkedIn Ads to Meta Muse with Adwarp, a free open-source MCP server. Run your own endpoint, add it in Muse, then size audiences and draft campaigns.
- [LinkedIn Ads in Grok: connect it with MCP | Adwarp](https://adwarp.dev/linkedin-ads/grok.md): Connect LinkedIn Ads to Grok Bot with Adwarp, a free open-source MCP server. Run your own endpoint, add it by chat, then size audiences and draft campaigns.
- [Google Ads in Claude: connect it with MCP | Adwarp](https://adwarp.dev/google-ads/claude.md): Connect Google Ads to Claude Code or Claude Desktop with Adwarp, a free open-source MCP server and CLI. Research keywords and build paused Search campaigns.
- [Google Ads in Codex | Adwarp](https://adwarp.dev/google-ads/codex.md): Connect Google Ads to OpenAI Codex with Adwarp, a free open-source MCP server and CLI. Research keywords and build paused Search campaigns from your terminal.
- [Google Ads in Cursor | Adwarp](https://adwarp.dev/google-ads/cursor.md): Connect Google Ads to Cursor with Adwarp, a free open-source MCP server and CLI. Research keywords from your landing page and build paused Search campaigns.
- [Google Ads CLI, open source | Adwarp](https://adwarp.dev/google-ads/cli.md): Run Google Ads from the command line with Adwarp, a free open-source CLI and MCP server. Research keywords, dry-run Search campaign launches and pull reports.
- [Google Ads in Gemini: connect it with MCP | Adwarp](https://adwarp.dev/google-ads/gemini.md): Connect Google Ads to Gemini with Adwarp, a free open-source MCP server and CLI. Add it to Antigravity CLI, then research keywords and build paused campaigns.
- [LinkedIn Ads in ChatGPT, coming soon | Adwarp](https://adwarp.dev/linkedin-ads/chatgpt.md): Adwarp, the free open-source LinkedIn Ads MCP server and CLI, is coming to ChatGPT. Use it today from Claude, Codex, Cursor or your terminal.
- [Google Ads in ChatGPT, coming soon | Adwarp](https://adwarp.dev/google-ads/chatgpt.md): Adwarp, the free open-source Google Ads MCP server and CLI, is coming to ChatGPT. Use it today from Claude, Codex, Cursor or your terminal.
- [Google Ads in Meta Muse, coming soon | Adwarp](https://adwarp.dev/google-ads/muse.md): Adwarp, the free open-source Google Ads MCP server, is coming to Meta Muse. LinkedIn Ads works in Muse today, and Google runs in Claude, Codex or Cursor.
- [Google Ads in Grok, coming soon | Adwarp](https://adwarp.dev/google-ads/grok.md): Adwarp, the free open-source Google Ads MCP server, is coming to Grok Bot. LinkedIn Ads works in Grok today, and Google runs in Claude, Codex or Cursor.
- [Docs: install, MCP server and CLI | Adwarp](https://adwarp.dev/docs.md): Install Adwarp, the free open-source MCP server and CLI for LinkedIn Ads and Google Ads, and look up every tool and command you can run from your terminal.
- [Install Adwarp from npm | Adwarp docs](https://adwarp.dev/docs/install.md): Install Adwarp from npm, sign in to LinkedIn from your terminal, and register the local MCP server with Claude Code, Claude Desktop, Cursor or any MCP client.
- [Create a LinkedIn developer app | Adwarp docs](https://adwarp.dev/docs/linkedin-app.md): Set up the LinkedIn developer app Adwarp runs against: the products to request, the redirect URL, ad account mapping and the OAuth scopes it asks for.
- [Set up Google Ads access | Adwarp docs](https://adwarp.dev/docs/google-ads-setup.md): Get a Google Ads developer token, create an OAuth client, write google.json or set environment variables, and sign in to Google Ads from your terminal.
- [Hosted MCP endpoint | Adwarp docs](https://adwarp.dev/docs/hosted.md): Connect to the hosted Adwarp MCP endpoint with your own LinkedIn credentials as request headers, see which tools need a local install, or self-host it.
- [Adwarp in Claude Code | Adwarp docs](https://adwarp.dev/docs/clients/claude-code.md): Add Adwarp to Claude Code as a local MCP server or through the hosted endpoint, check it with a read-only question, then install the skills on top of it.
- [Adwarp in Claude Desktop | Adwarp docs](https://adwarp.dev/docs/clients/claude-desktop.md): Add Adwarp to the Claude Desktop MCP config file, restart the app, and check the connection with a read-only question about your LinkedIn ad accounts.
- [Adwarp in Codex | Adwarp docs](https://adwarp.dev/docs/clients/codex.md): Add Adwarp to the Codex CLI as a local MCP server with 1 command, check that it works, and script the same tools with the adwarp command when you need to.
- [Adwarp in Cursor | Adwarp docs](https://adwarp.dev/docs/clients/cursor.md): Add Adwarp to Cursor with 1 click or 1 entry in mcp.json, then ask the Cursor agent a read-only question to check that it reaches your ad accounts.
- [Adwarp in Gemini | Adwarp docs](https://adwarp.dev/docs/clients/gemini.md): Add Adwarp to Antigravity CLI or Gemini CLI with 1 command, then ask Gemini a read-only question to check that it reaches your LinkedIn and Google ad accounts.
- [Adwarp CLI setup | Adwarp docs](https://adwarp.dev/docs/clients/cli.md): Run Adwarp from your terminal with no AI client: install the adwarp command, sign in, check that it works, change single ads and put reports on cron.
- [Adwarp in Meta Muse | Adwarp docs](https://adwarp.dev/docs/clients/muse.md): Deploy your own Adwarp endpoint to Vercel, add it to Meta Muse with 1 bearer token, then check with a read-only question that it reaches LinkedIn Ads.
- [Adwarp in Grok Bot | Adwarp docs](https://adwarp.dev/docs/clients/grok.md): Deploy your own Adwarp endpoint to Vercel, add it to xAI's Grok Bot with 1 header, then check with a read-only question that it reaches LinkedIn Ads.
- [LinkedIn Ads in Adwarp | Adwarp docs](https://adwarp.dev/docs/linkedin-ads.md): What Adwarp does on LinkedIn Ads, area by area: targeting, audiences, campaigns, reporting, Ad Library research and the change journal, with its tools.
- [Google Ads in Adwarp | Adwarp docs](https://adwarp.dev/docs/google-ads.md): Create paused Google Ads Search campaigns, research keywords and report on performance from your terminal, under 3 house rules that protect B2B budgets.
- [MCP tools reference | Adwarp docs](https://adwarp.dev/docs/tools.md): Every tool the Adwarp MCP server exposes for LinkedIn Ads and Google Ads, grouped by area, with its hosted endpoint support and its matching CLI command.
- [Accounts tool | Adwarp docs](https://adwarp.dev/docs/tools/accounts.md): The Adwarp MCP tool that lists the LinkedIn ad accounts your developer app can reach, with its inputs, hosted endpoint support and matching CLI command.
- [Targeting tools | Adwarp docs](https://adwarp.dev/docs/tools/targeting.md): Adwarp MCP tools that resolve LinkedIn targeting facets to entity URNs and estimate audience size, with every input, hosted support and the CLI command.
- [Audiences tools | Adwarp docs](https://adwarp.dev/docs/tools/audiences.md): Adwarp MCP tools that upload CSV lists, Salesforce queries and HubSpot lists as LinkedIn matched audiences and check match status, with hosted support.
- [Conversions tool | Adwarp docs](https://adwarp.dev/docs/tools/conversions.md): The Adwarp MCP tool that lists the insight-tag conversions on a LinkedIn ad account, so a campaign can track 1, with its inputs, hosted support and CLI.
- [Campaigns tools | Adwarp docs](https://adwarp.dev/docs/tools/campaigns.md): Adwarp MCP tools that create LinkedIn campaign groups, campaigns and ads as drafts, change them in place and pause or resume single ads, with every input.
- [Orchestrator tool | Adwarp docs](https://adwarp.dev/docs/tools/orchestrator.md): The Adwarp MCP tool that creates a LinkedIn audience, campaign group, campaign and draft ads from 1 brief in a single call, with every input it takes.
- [Reporting tools | Adwarp docs](https://adwarp.dev/docs/tools/reporting.md): Adwarp MCP tools for LinkedIn Ads reporting: account rollups with flags, per-entity metrics and weekly or monthly trends, with every input and CLI command.
- [Competitor intel tools | Adwarp docs](https://adwarp.dev/docs/tools/competitor-intel.md): Adwarp MCP tools that read any company's LinkedIn ads from the official Ad Library API and collect creative copy, with their inputs and hosted limits.
- [Change journal tools | Adwarp docs](https://adwarp.dev/docs/tools/change-journal.md): Adwarp MCP tools that log ad changes, list them and compute before and after lift for each one, with every input, the CLI commands and why they run locally.
- [Google Ads tools | Adwarp docs](https://adwarp.dev/docs/tools/google-ads.md): The Adwarp gads tools for Google Ads: accounts, keyword ideas, campaigns, ads, conversion actions, paused Search launches, reporting and read-only GAQL.
- [Targeting spec | Adwarp docs](https://adwarp.dev/docs/tools/targeting-spec.md): How the structured LinkedIn targeting spec in Adwarp maps short facet names to entity URNs, and how included and excluded facets combine in a campaign.
- [Salesforce audiences | Adwarp docs](https://adwarp.dev/docs/salesforce.md): Turn a Salesforce SOQL query into a LinkedIn matched audience with Adwarp, using your existing sf CLI login, from the MCP server or the adwarp command.
- [HubSpot audiences | Adwarp docs](https://adwarp.dev/docs/hubspot.md): Turn a HubSpot list or CRM search into a LinkedIn matched audience with Adwarp, using a read-only private app token, from the MCP server or the CLI.
- [Paid ads skills for LinkedIn and Google Ads | Adwarp docs](https://adwarp.dev/docs/skills.md): 17 open-source skills for LinkedIn Ads and Google Ads that run in Claude Code, Codex or Cursor, from a CSV export or live through Adwarp.
- [LinkedIn Ads audit skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-ads-audit.md): A scored LinkedIn Ads audit: 28 checks across tracking, targeting, delivery settings, bidding, creative and UTMs, with fixes ranked by spend at risk.
- [LinkedIn Ads performance review skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-ads-performance-review.md): Review a LinkedIn Ads account by campaign, ad set and ad against like-for-like peers, with scale, pause, refresh and watch lists ranked by money at stake.
- [LinkedIn Ads spend analysis skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-ads-spend-analysis.md): See where LinkedIn ad budget goes, how concentrated it is, which spend returns nothing, and the reallocation moves worth making, ranked by the money involved.
- [LinkedIn Ads lead drivers skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-ads-lead-drivers.md): Rank which LinkedIn ads drive leads and which burn budget without converting, with a drivers list, a pause list and the copy angles that convert.
- [LinkedIn Ads pause rules skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-ads-pause-rules.md): Set LinkedIn ad pause rules once, see a dry-run table every week, and pause nothing until you confirm the exact list, with every pause logged with its reason.
- [LinkedIn audience sizing skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-audience-sizing.md): Size LinkedIn targeting before you spend: a narrowing ladder with the estimate after each step, a range for the goal, and a check against the budget.
- [LinkedIn matched audiences skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-audience-ops.md): Audit LinkedIn matched audiences for stuck, small, stale and unused lists, upload clean lists after a dry run, and refresh audiences from your CRM.
- [LinkedIn ABM builder skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-abm-builder.md): Turn an account list into 1:1 LinkedIn ad sets: a buying group sized per account, 3 ads with distinct angles, a fixed flight and a coverage file for sales.
- [LinkedIn campaign launch skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-campaign-launch.md): Go from a plain-language ask to a confirmed brief and a draft LinkedIn campaign, ad sets and ads, sized before any spend and built with safe defaults.
- [LinkedIn Ad Library teardown skill | Adwarp docs](https://adwarp.dev/docs/skills/linkedin-ad-library-teardown.md): Read any company's ads in LinkedIn's public Ad Library and sum up their themes, offers, formats, cadence, run length and the gaps you can use.
- [Google Ads account audit skill | Adwarp docs](https://adwarp.dev/docs/skills/google-ads-account-audit.md): A read-only Google Ads audit: 50 checks, each with a GAQL query and a source, across tracking, settings, keywords, Performance Max and AI Max.
- [Google Ads search campaign builder skill | Adwarp docs](https://adwarp.dev/docs/skills/google-ads-search-campaign-builder.md): Turn a product, landing page, location and budget into a paused Google Ads Search campaign brief, with keywords, ad groups, negatives and responsive ads.
- [Google Ads search terms skill | Adwarp docs](https://adwarp.dev/docs/skills/google-ads-search-terms.md): Find wasted spend in the Google Ads search terms report with n-gram analysis, negative keyword candidates checked against your keywords, and an upload file.
- [Paid media weekly report skill | Adwarp docs](https://adwarp.dev/docs/skills/paid-media-weekly-report.md): A fixed-format weekly report for LinkedIn Ads and Google Ads: the last 7 days against the 7 before, movers held to floors, flags and exactly 3 actions.
- [Paid media daily health check skill | Adwarp docs](https://adwarp.dev/docs/skills/paid-media-health-check.md): A daily check of LinkedIn Ads and Google Ads that stays silent unless something is wrong: no delivery, spend spikes, cost blowouts or broken tracking.
- [Ad experiment lift skill | Adwarp docs](https://adwarp.dev/docs/skills/ad-experiment-lift.md): Log a hypothesis before an ad change, then read before and after lift with a placebo window, a control and the confounds stated, on LinkedIn or Google.
- [Ad budget pacing skill | Adwarp docs](https://adwarp.dev/docs/skills/ad-budget-pacing.md): Project month-end spend on LinkedIn Ads and Google Ads against your cap, stay quiet when on pace, and propose the daily budget change when you aren't.
- [Change journal and lift | Adwarp docs](https://adwarp.dev/docs/journal.md): How Adwarp journals every change to a LinkedIn ad entity, and how it compares performance in the window before a change against the window after it.
- [Safety rules | Adwarp docs](https://adwarp.dev/docs/safety.md): The rules Adwarp follows so nothing spends without you: drafts and paused campaigns first, explicit activation, audience limits and where secrets live.
- [CLI commands reference | Adwarp docs](https://adwarp.dev/docs/cli.md): Every adwarp CLI command for LinkedIn Ads and Google Ads, with its options, the reporting periods and how to run any command without installing it first.
- [Configuration reference | Adwarp docs](https://adwarp.dev/docs/config.md): The Adwarp config file, where OAuth tokens live, the environment variables a hosted deploy reads, and the names from before the rename that still work.
- [Privacy policy | Adwarp](https://adwarp.dev/privacy.md): What Adwarp records on adwarp.dev, in the local CLI and MCP server, and on the hosted endpoint. Your credentials stay with you, and nothing is sold.
- [Terms of service | Adwarp](https://adwarp.dev/terms.md): The terms for adwarp.dev, the Adwarp CLI and MCP server, and the hosted endpoint: MIT licensed, run on your own ad accounts, drafts first, no warranty.

## Optional

- [Source code on GitHub](https://github.com/adwarp-dev/adwarp)
- [Docs in the agent repo](https://github.com/adwarp-dev/adwarp/tree/main/docs)
- [npm package](https://www.npmjs.com/package/adwarp)