Run Meta Ads from Claude Code
Manage Facebook and Instagram campaigns from your terminal — 36 Meta tools, agent-loop scripting, available on the official Claude plugin marketplace.
15 tool calls / month free · No credit card · Setup in ~2 minutes
Adspirer is the MCP server that connects Claude Code (Anthropic's terminal CLI) to your Meta ad accounts. Install in one command via the official `claude-plugins-official` marketplace (`/plugin install adspirer-ads-agent@claude-plugins-official`), authenticate once with OAuth, and Claude Code can run all 36 Meta tools from your terminal — image / video / carousel / Reels / DCO campaign creation, creative-fatigue detection, audience research, placement optimization, lead-form pulls, and ad-set management. Because Claude Code runs in agent loops, you can drop a multi-step brief, walk away, and come back to a finished report — or wire Adspirer prompts into shell scripts, cron jobs, and CI for nightly Meta audits. New campaigns always create paused, Adspirer cannot delete existing campaigns or modify budgets without confirmation, and the free tier (15 calls / month) covers a full audit before you upgrade.
What you can do
36 tools across Meta Ads. The eight you'll use most:
Launch new campaigns
Build image, video, carousel, DCO, or Reels campaigns from a brief. Adspirer validates creative against Meta's requirements, plans the ad sets, and creates everything paused so you review before going live.
Pause underperformers
Pause individual ads, ad sets, or full campaigns by name from chat. Resume them later just as easily — Adspirer cannot delete existing campaigns (hard-coded safety).
Audit creative fatigue
Surface ads that have been running 14+ days with declining CTR — Adspirer recommends which creatives to refresh before they tank performance.
Find wasted spend
Flag campaigns running under your ROAS threshold so you can pause or reallocate budget. Works across active and paused campaigns.
Research audiences
Search Meta's targeting catalog by interest, demographic, or behavior. Browse existing custom audiences (lists, lookalikes, website, engagement) before building new ones.
Pull lead-form submissions
List configured lead forms and pull recent submissions, grouped by campaign — route them into your CRM workflow without leaving chat.
Optimize placements & budget
Compare CPA across Feed, Stories, Reels, Marketplace, and Audience Network. Reallocate budget toward winning ad sets — Adspirer never increases an existing budget without explicit confirmation.
Diagnose anomalies
When CPA spikes or CTR drops, ask why. Adspirer inspects audience changes, creative rotation, and platform-level events to explain the cause and recommend a fix.
Campaign types you can launch
Every Meta Ads format Adspirer supports — request one in chat and Claude Code builds the campaign paused for review.
Image campaigns
Single-image ads across Feed, Stories, and Marketplace. 1080×1080 minimum, validated before launch.
Video campaigns
Video ads up to 240s, 1:1 / 4:5 / 9:16 aspect ratios. MP4 or MOV, validated against Meta's spec.
Carousel campaigns
2–10 cards per ad, each with their own creative + headline + link. Great for product catalogs.
Reels campaigns
Vertical video for Instagram Reels and Facebook Reels. 9:16 aspect, optimized for mobile feeds.
Lead Gen Forms
On-platform forms that capture leads inside Facebook / Instagram — no landing page needed.
DCO (Dynamic Creative Optimization)
Provide multiple creative variants; Meta auto-mixes images, headlines, and descriptions to find winners.
Sample prompts
Claude Code shines on multi-step agent tasks — drop a brief, walk away, get a report.
Meta performance audit — A monthly audit that surfaces which campaigns to keep, kill, or scale.
Creative fatigue check — Catch fatigued ads before they drag down ad-set performance.
Launch an image campaign — End-to-end image campaign creation, with creative validation first.
Optimize placements — Move spend toward the placements that are actually converting for you.
Lead-form pull — Quick pull of lead-gen data without leaving chat.
Diagnose a CPA spike — Anomaly diagnosis that explains *why*, not just *that*.
Who this is for
Real workflows from people running Meta Ads through Claude Code.
Growth engineer on a B2C team running scripted Meta ops
Drop a brief in Claude Code: "every weekday at 9am, pull yesterday's Meta spend, ROAS, and frequency by campaign, flag anything with frequency > 3 or 7-day CTR decline > 20%, write the report to `reports/meta/$(date).md`." Wire it into cron via Claude Code's headless mode.
Outcome: A daily creative-fatigue and pacing watch — written, scheduled, and version-controlled like any other shell script. Catches fatigue 1-2 weeks before manual review.
DevOps-flavored agency operator running Meta for 5+ clients
Use the brand-workspace pattern: `cd ~/clients/{brand} && claude` triggers `/adspirer:setup`, which scans the brand's `CLAUDE.md` for voice + audience and pulls live Meta data. Repeat per client; every audit follows the same SOP.
Outcome: Cuts onboarding a new Meta client from a half-day setup to about 10 minutes, and every weekly audit runs the same sequence regardless of who's on call.
Marketing engineer at a DTC startup automating creative refreshes
Write a Claude Code prompt that loops: detect creative fatigue → pull top-performing creative briefs from `briefs/` → draft 3 replacement copy variants → output a paused duplicate campaign via `duplicate_meta_campaign`. Run it whenever a CTR alert fires.
Outcome: Fatigue-detection-to-replacement-creative-brief in a single agent run; the marketer reviews briefs in the morning, ships them by lunch.
Solo founder who already uses Claude Code for product work
Same terminal that builds the product now manages the Meta launch. Brief Claude Code: "build a Meta image campaign at $30/day for our beta list lookalike, validate the creative URL, write three primary text variants, create paused" — review the output and unpause when ready.
Outcome: No new tool to learn, no Ads Manager UI required; product code and ad ops live in the same terminal session.
Adspirer vs alternatives
For running Meta Ads from Claude Code.
| Capability | Adspirer (this page) | DIY MCP server | Legacy SaaS dashboard |
|---|---|---|---|
| Install | `/plugin install adspirer-ads-agent@claude-plugins-official` | Build MCP server, write CLI plugin | No CLI — dashboard only |
| Cost — entry tier | Free (15 calls / mo) | Hosting + maintenance | $200-500 / mo minimum |
| Agent-loop / headless mode | Yes — works in scripts, cron, CI | Whatever you build | No |
| Brand-workspace pattern | `/adspirer:setup` → CLAUDE.md | Manual | No equivalent |
| Slash commands | 5 prebuilt (setup, performance-review, write-ad-copy, wasted-spend, refresh-brand-context) | Manual | No |
| Multi-account | Yes — `switch_primary_account` | Manual per-account auth | Yes — but each account billed |
| Write capability | Image / video / carousel / Reels / DCO, paused on create | Whatever you build | Mostly read-only |
| Safety: cannot delete | Hard-coded — no delete tool | Up to you | Varies |
Pricing
Start free. Upgrade if you outgrow it.
How it works
From sign-up to your first launched campaign in three steps.
Connect
Paste the Adspirer MCP URL into Claude Code, complete OAuth in your browser, and link your Meta Ads account. About 2 minutes.
Manage
Ask Claude Code for an audit, launch a new campaign, pause underperformers, or pull a report. Adspirer handles the 36 Meta Ads tools behind the scenes.
Scale
Switch between accounts in chat, run the same audit across clients, and let agency SOPs live in your AI assistant — no extra dashboard logins.
Frequently asked questions
About running Meta Ads from Claude Code.
Connect Claude Code to Adspirer
For technical readers — the exact steps. Most users finish this in about 2 minutes. Required: Claude API access (or Claude.ai Pro / Max).
Add Adspirer to Claude Code
Run in your terminal:
claude mcp add --transport http adspirer https://mcp.adspirer.com/mcp Authenticate
Claude Code launches your browser for OAuth. Sign in to Adspirer and link your ad accounts.
Verify
Run claude and ask: Check my connected ad platforms. Tools should now appear in the available-tools list.
Related integrations
Same Claude Code, different platform — or same Meta Ads, different AI client.
Claude Code × other platforms
Meta Ads × other AI clients
- ChatGPT × Meta Ads →
- Claude × Meta Ads →
- Cursor × Meta Ads →
- Codex CLI × Meta Ads →
- Windsurf × Meta Ads →
- Gemini CLI × Meta Ads →
- OpenClaw × Meta Ads soon
- Manus × Meta Ads soon
Go deeper
Ready to connect Claude Code to Meta Ads?
Start free — 15 tool calls per month, no credit card. Setup takes about 2 minutes.
Try Adspirer freeLast updated April 28, 2026.