📈Marketing & Sales · Development & Programming · Business & Productivity

AdHelm CLI

AdHelm is a free, Apache-2.0 command-line tool that connects your AI agent to your own advertising and analytics accounts, so it can report performance, audit what was read and recommend changes entirely locally. It is read-only in version 0.1.101 and supports Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Reddit Ads, OpenAI Ads, GA4 and GTM as EXPERIMENTAL providers.

AdHelm CLI
MarketingDeveloper ToolsAutomation

Key facts

What is AdHelm CLI?

An agent-first, local-only CLI that audits your ad and analytics accounts and recommends changes without ever touching them.

Who is AdHelm CLI best for?

Marketers, growth and performance teams, and developers working with ad platform APIs on macOS, Linux or Windows

Does AdHelm CLI have a free plan?

According to official sources, a free plan is available.

What are its main limitations?

  • Every provider in 0.1.1 is labeled EXPERIMENTAL: fixture-tested but not yet piloted on a live account
  • No changes to any ad or analytics account — no write capabilities yet
  • No CRM attribution (Salesforce, HubSpot)
  • You must obtain provider API access yourself, and quotas and access tiers are the provider's

Limitations are based on product materials or editorial synthesis; confirm on the official site.

When was this information verified?

October 13, 2026

Sources

Key features

  • ✓Connect: enroll your own provider app or API key locally, check status, refresh, remove locally, and get revocation guidance
  • ✓Read: reports account identity, a fixed inventory and a fixed daily aggregate report
  • ✓Audit: audits state per dimension, shows what was and wasn't read, and gives recommendations that cite their evidence
  • ✓Record: append-only local history you can verify, reconcile against out-of-band changes, and export as deterministic CSV and JSON
  • ✓Report: compact chat summaries by default, with documents, spreadsheets or HTML reports on request
  • ✓Teach: two bundled agent skills teach the diagnose, recommend and verify loop
  • ✓Agent-first workflow via adhelm discover — you describe the goal and the agent runs the commands
  • ✓Credentials kept in your own OS credential store, with no hosted service, telemetry, account, license key or paid tier

Use cases

  • →Auditing Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads or Reddit Ads accounts for performance and state
  • →Reviewing GA4 and GTM analytics data alongside paid media performance
  • →Producing deterministic CSV and JSON exports of ad account history for reconciliation
  • →Generating chat, document, spreadsheet or HTML performance reports on request
  • →Giving an AI agent a read-only, evidence-citing diagnose-recommend-verify loop over advertising accounts

Pricing

Free / Open Source

$0

  • · Free, Apache-2.0 licensed CLI
  • · No paid tier, no license key
  • · Install with `uv tool install adhelm` or `pipx install adhelm`
  • · Requires Python 3.12+; macOS, Linux and Windows

AdHelm is free and open source under Apache-2.0, with no paid tier.

Pros

  • +Free and open source under the Apache-2.0 license
  • +Read-only in 0.1.101 — write commands are listed as unreleased and refused
  • +Runs entirely locally with no hosted service, telemetry, account or license key
  • +You register your own provider apps and keep credentials in your OS credential store
  • +Append-only, verifiable local history with deterministic CSV and JSON exports

Cons

  • −Every provider in 0.1.1 is labeled EXPERIMENTAL: fixture-tested but not yet piloted on a live account
  • −No changes to any ad or analytics account — no write capabilities yet
  • −No CRM attribution (Salesforce, HubSpot)
  • −You must obtain provider API access yourself, and quotas and access tiers are the provider's

Positioning

  • Core value: An agent-first, local-only CLI that audits your ad and analytics accounts and recommends changes without ever touching them.
  • Ideal for: Marketers, growth and performance teams, and developers working with ad platform APIs on macOS, Linux or Windows
  • Product type: Open-source command-line tool (Python package installed via uv or pipx)

Frequently asked questions

What is AdHelm?

AdHelm is a free, Apache-2.0 command-line tool that lets your AI agent connect your own ad and analytics accounts, report performance, audit them and recommend changes, entirely on your machine.

How much does AdHelm cost?

AdHelm is free and open source under the Apache-2.0 license. It has no hosted service, account, license key or paid tier.

Does AdHelm change my ad accounts?

No. Version 0.1.101 is read-only; write commands are listed as unreleased and refused, and recommendations change nothing.

Which ad and analytics providers are supported?

Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Reddit Ads, OpenAI Ads, GA4 and GTM. Every provider in 0.1.1 is labeled EXPERIMENTAL: fixture-tested, not yet piloted on a live account.

How do I install AdHelm?

Run `uv tool install adhelm` or `pipx install adhelm`, then `adhelm discover`. It requires Python 3.12+ and runs on macOS, Linux and Windows.

Where are my credentials stored?

You register your own provider applications and keep your own credentials in your OS credential store; AdHelm has no hosted service or telemetry.

You may also like

Curated suggestions based on similar categories.

See all alternatives →