Using Pipeboard with Claude Code
Manage Meta Ads and Google Ads from Claude Code. Choose MCP for the full tool experience, or the CLI for faster execution.
Two Ways to Connect
Both options give Claude Code full access to your ad accounts. Pick the one that fits your workflow.
MCP
More mature- Native MCP protocol integration
- Claude sees all available tools automatically
- OAuth authentication (no API token needed)
- Richer tool descriptions and schemas
- Separate servers for Meta Ads and Google Ads
CLI
Faster- Sub-50ms startup — no server overhead
- All platforms in one binary (Meta + Google)
- 117+ commands with --help for discovery
- API token auth (one-time setup)
- Scriptable — pipe JSON output, chain commands
Setup via MCP
Add Pipeboard MCP servers to Claude Code using the claude mcp add command.
Add Meta Ads MCP Server
Run this in your terminal to register the Meta Ads MCP server
claude mcp add meta-ads-mcp \
--transport http \
https://meta-ads.mcp.pipeboard.co/Add Google Ads MCP Server
Run this to register the Google Ads MCP server
claude mcp add google-ads-mcp \
--transport http \
https://google-ads.mcp.pipeboard.co/Verify and Use
Start Claude Code and ask it to use your ad tools
# List registered MCP servers
claude mcp list
# Start Claude Code and try it out
claude
> Show me my Meta Ads campaigns from last weekClaude Code will automatically discover the available tools from each MCP server.
Setup via CLI
Install the Pipeboard CLI and let Claude Code shell out to it. Faster startup, all platforms in one binary.
Install the CLI
brew install pipeboard-co/tap/pipeboardOr use go install github.com/pipeboard-co/pipeboard-cli@latest on any platform with Go 1.21+.
Authenticate
Get your API token from pipeboard.co/api-tokens and configure the CLI.
pipeboard config set token YOUR_TOKEN_HERE
pipeboard refreshUse with Claude Code
Claude Code can call the CLI through its Bash tool. Just ask naturally.
# Start Claude Code
claude
# Then ask:
> Use pipeboard to show me my Meta Ads campaigns
> Run pipeboard google-ads list-customers
> Get my ad performance for the last 7 days using pipeboardClaude Code will run pipeboard commands and parse the JSON output automatically.
Tips for Claude Code
Get the most out of Pipeboard with Claude Code
CLI is great for multi-step workflows:
"List my campaigns, find the ones with CPA over $20, then pause them." Claude Code will chain multiple CLI calls.
MCP is better for exploratory analysis:
"Analyze my ad performance and recommend optimizations." MCP gives Claude richer context about what tools are available.
Use --help for discovery:
Tell Claude Code to run pipeboard meta-ads --help to see all 67 Meta Ads commands, or pipeboard google-ads --help for all 50 Google Ads commands.
What You Can Do
Audit all campaigns and create a performance report
Find underperforming ads and pause them
Duplicate a winning ad with different creative
Create a new campaign from scratch with targeting
Get insights across Meta and Google in one conversation
Bulk update budgets across multiple ad sets
Need Help?
We can help you get set up quickly
Related Guides
Continue learning with these recommended guides.