GuidesPipeboard CLI

Pipeboard CLI

Manage Meta Ads and Google Ads from your terminal. Single binary, zero dependencies, 117+ commands. Built for AI agents and automation scripts.

What is the Pipeboard CLI?

The Pipeboard CLI is a command-line tool that lets you manage your Meta Ads and Google Ads campaigns directly from your terminal. It connects to Pipeboard servers, so your API tokens never leave the server side.

Perfect for AI coding agents (Claude Code, Cline, OpenClaw), automation scripts, and anyone who prefers the terminal over a web UI.

Why use the CLI:

All platforms in one binary — Meta Ads and Google Ads without separate MCP servers
117+ commands covering campaigns, creatives, audiences, reporting, and more
Sub-50ms startup — fast enough for AI agents to shell out to
Scriptable — pipe JSON output into jq, chain commands in bash, run from CI
Open source — full source code on GitHub

Installation

Choose your platform

macOS / Linux (Homebrew)

Recommended. Installs and auto-updates.

Terminal
brew install pipeboard-co/tap/pipeboard

Any platform (Go install)

Works on macOS, Linux, and Windows. Requires Go 1.21+.

Terminal
go install github.com/pipeboard-co/pipeboard-cli@latest

Windows / Manual download

Pre-built binaries for macOS (arm64/amd64), Linux (arm64/amd64), and Windows (amd64).

Download from GitHub Releases

Verify installation:

$ pipeboard version
pipeboard 0.2.0 (commit: 238712b)

Authentication

Connect the CLI to your Pipeboard account

1. Get your API token from your Pipeboard account:

pipeboard.co/api-tokens →

2. Save it to your CLI config (one-time setup):

Terminal
pipeboard config set token YOUR_TOKEN_HERE

Or use an environment variable: export PIPEBOARD_API_TOKEN=pk_...

3. Load the available commands:

Terminal
pipeboard refresh

This fetches the latest tool definitions from Pipeboard servers. Run it once after installing, and again when new tools become available.

Your First Command

Start managing your ads

List your Meta ad accounts:

Terminal
pipeboard meta-ads get-ad-accounts

List your Google Ads customers:

Terminal
pipeboard google-ads list-customers

More examples:

# Get campaign performance insights
pipeboard meta-ads get-insights --object-id act_123 --date-preset last_30d

# List Google Ads campaigns
pipeboard google-ads get-campaigns --customer-id 1234567890

# Create a Meta Ads campaign
pipeboard meta-ads create-campaign \
  --account-id act_123 \
  --name "Spring Sale" \
  --objective OUTCOME_SALES

# Duplicate an ad for A/B testing
pipeboard meta-ads duplicate-ad --ad-id 12345

Getting Help

Discover all available commands

Every command has built-in help with descriptions, flags, and required parameters. Use --help at any level to see what is available.

# See all top-level commands
pipeboard --help

# See all Meta Ads commands (67 commands)
pipeboard meta-ads --help

# See all Google Ads commands (50 commands)
pipeboard google-ads --help

# See flags and usage for a specific command
pipeboard meta-ads create-campaign --help
pipeboard google-ads get-campaigns --help

Flags are auto-generated from each tool's JSON Schema. Required flags are enforced, and enum values are shown in help text.

Command Reference

Meta Ads 67 commands

  • Campaigns — create, update, duplicate, bulk update
  • Ad Sets — create, update, duplicate, budgets
  • Ads — create, update, duplicate, A/B test
  • Creatives — images, videos, carousels
  • Audiences — custom, lookalike, interest targeting
  • Insights — performance reports, email reports
  • Lead Gen — forms, publishing, status
  • Product Catalogs — list catalogs, product sets
pipeboard meta-ads --help

Google Ads 50 commands

  • Campaigns — search, PMax, display, video
  • Ad Groups — create, update, metrics
  • Ads — responsive search ads, enable/pause
  • Keywords — add, remove, bids, negatives
  • Audiences — segments, targeting, geo/device
  • Extensions — sitelinks, callouts, snippets
  • Assets — images, text, YouTube videos
  • GAQL — arbitrary read queries and mutate ops
pipeboard google-ads --help

Full command reference with all flags and descriptions: github.com/pipeboard-co/pipeboard-cli →

Building AI Agents

Use the CLI in your own automation

The CLI is designed to be called by AI agents and scripts. Your agent can shell out to pipeboard commands and parse the JSON output.

Example: Agent workflow
# 1. List accounts
pipeboard meta-ads get-ad-accounts

# 2. Get campaign performance
pipeboard meta-ads get-insights \
  --object-id act_123 \
  --date-preset last_7d

# 3. Create a new campaign based on analysis
pipeboard meta-ads create-campaign \
  --account-id act_123 \
  --name "AI-optimized campaign" \
  --objective OUTCOME_SALES

# 4. Create an ad set with targeting
pipeboard meta-ads create-adset \
  --account-id act_123 \
  --campaign-id 456 \
  --name "Target audience" \
  --daily-budget 2000

You can also use Pipeboard as a remote MCP server if your agent supports MCP natively:

Meta Ads MCP

https://mcp.pipeboard.co/meta-ads-mcp

View guide →

Google Ads MCP

https://mcp.pipeboard.co/google-ads-mcp

View guide →

Ready to get started?

Install the CLI and start managing your ads from the terminal in under a minute.

No credit card required