How to connect Claude to Meta Ads
Connect Meta inside Whathead
On the Integrations page, sign in with Facebook and choose the ad accounts and Pages Whathead may use. Claude can only reach what this connection reaches.
Add a custom connector in Claude
On claude.ai or Claude Desktop, go to Customize > Connectors, click "+ Add", then "Add custom connector".
Paste the endpoint
Name it Whathead, enter https://www.whathead.com/mcp and click "Continue". Review the detected sign-in settings, click "Continue", then "Add".
Sign in and approve
Sign in with the Whathead workspace that holds your Meta connection and approve access.
Switch it on in a chat
Click "+" in the lower left of the message box, open "Connectors" and toggle Whathead on for that conversation.
What to set up in Whathead first
Claude sees exactly what your Whathead workspace allows.
- A plan with MCP: MCP Actions ($39/month, 3 ad accounts), Operator Bundle ($65, 5 accounts) or Agency ($249, 15 accounts). Builder ($29) has no MCP.
- The 14-day trial covers 1 ad account, 200 MCP reads, 10 write operations and 2 live actions: enough for an audit and one paused build.
- Lead exports need the Page that owns the lead form to be connected.
- Optional: on /connectors/mcp, restrict the connector to chosen ad accounts, platforms or tools.
Copy-paste prompts for Meta Ads
Audit Meta ad account [name] for the last 30 days: rank campaigns by spend, show CPA and ROAS, and flag ad sets with frequency above 3.
Find ad sets that spent over $200 in the last 14 days with zero purchases. Show spend and the optimization event for each.
Compare month-to-date spend for every campaign with its budget. Which will overspend or underspend by month end?
For ads live longer than 21 days, compare CTR in the last 7 days with their first 7 days. List ads down more than 30%.
Break down last week's spend and CPA by placement (Feed, Reels, Stories) for campaign [name].
Duplicate ad set [name] with a 20% higher daily budget, paused. Show me the dry run first.
Draft a Sales campaign for [product] with a broad ad set and a purchaser lookalike, three ads each, all paused.
Pause every ad with CPA above $60 over the last 7 days. List them and wait for my confirmation.
Add a budget schedule that raises campaign [name] by 30% from 27 to 30 November.
Copy my best Meta campaign from last month to TikTok as a paused campaign, vertical creatives only.
What Claude can and cannot do in Meta Ads
| Task | Claude via Whathead | Notes |
|---|---|---|
| Read campaigns, ad sets, ads and insights | Yes | Any date range and breakdown the Marketing API supports |
| Create campaigns, ad sets, ads and creatives | Yes, dry run first | Live creation needs confirmation |
| Change budgets, bids, schedules, targeting, status | Yes | Includes budget schedules |
| Duplicate campaigns, ad sets and ads | Yes | Uses Meta's copy endpoints |
| Export leads, manage audiences, catalogs, pixels | Yes | Within the assets you connected |
| Delete objects | Yes, with confirmation | 34 actions are classed as destructive |
| Skip Meta ad review | No | New and edited ads are still reviewed by Meta |
| Reach accounts you did not connect or allow | No | Restrictions can narrow access further |
| Monitor accounts around the clock | Not in chat | Use the Whathead Anomaly Engine for ongoing checks |
How writes are kept safe
Whathead writes default to dry_run: true, so Claude first shows the exact request it would send to Meta. Executing takes a second call with dry_run: false, and publishing, deleting or billing changes also need confirmed: true. Idempotency keys stop a retried call from creating a second campaign.
In Claude, tool permissions can be set to Always allow, Needs approval or Blocked. Keep write tools on Needs approval until you trust the workflow.
Troubleshooting
Common fixes:
- "Your plan does not include connectors": the workspace is on Builder or has no active plan.
- Whathead missing from a chat: switch it on under "+" > "Connectors". The toggle is per conversation.
- Sign-in fails: use https://www.whathead.com/mcp exactly, not the non-www domain or a preview URL. If the default OAuth client option fails, choose "Register automatically"; Whathead supports dynamic client registration.
- An ad account is missing: it is not selected on the Integrations page, or a connector restriction excludes it.
Frequently asked questions
Is Meta's own Ads MCP server enough?
It can be. Meta's Ads MCP server, in open beta since 29 April 2026, documents 88 tools in seven categories, from reporting and campaign editing to catalogs and signals. Since 16 July 2026 admins can set rules for agents. If you only run Meta, start there. Whathead adds TikTok, Snapchat, Google Ads and more in the same chat, plus cross-platform transfer.
Which Claude plans support this?
Free (one custom connector), Pro, Max, Ultra, Team and Enterprise. On Team and Enterprise an Owner adds Whathead under Organization settings > Connectors, then members click "Connect" in Customize > Connectors.
Can Claude publish Meta ads live?
Yes, after a dry run and your explicit confirmation. You can also ask for everything paused and switch it on yourself.
Does it work in the Claude mobile app?
Yes. Once connected on the web or in Claude Desktop, Whathead is available in Claude for iOS and Android.
Do dry runs count toward my usage?
No. Only successful live work is metered. Drafts, failed jobs and dry runs do not consume paid usage.
Run it from one workspace
Every plan starts with a 14-day free trial. Only successful live work is metered.
Sources
- Claude Help Center: custom connectors using remote MCP (support.claude.com)
- Claude Help Center: use connectors (support.claude.com)
- Meta: Meta ads AI connectors announcement (facebook.com)
- Meta docs: Ads MCP server overview (seven tool categories) (developers.facebook.com)
- Meta for Developers: ads MCP server opened to any developer app (16 Jul 2026) (developers.facebook.com)