Integration · Claude Code × Meta Ads
Run Meta Ads inside Claude Code
NotFair connects Claude Code to live Meta Ads through the same hosted MCP endpoint used across the product. Campaigns, ad sets, ads, spend, frequency, CPM, CTR, conversions, and audience overlap across Facebook and Instagram.
Connect your Meta Ads account
Authorize once at notfair.co — then open Claude Code and start asking real questions about your account.
Setup
Connect Claude Code in three steps
Claude Code uses NotFair's hosted Streamable HTTP endpoint. NotFair hosts the Meta Marketing API app. You authorize existing ad accounts through OAuth; you do not create a Meta developer app.
1. Register NotFair as an MCP server
Add NotFair to Claude Code's MCP config from your terminal. The hosted URL is the same for every platform.
claude mcp add NotFair-MetaAds --scope user --transport http https://notfair.co/api/mcp/notfair2. Authorize Meta Ads
Open /connect/meta-ads/any-mcp on notfair.co, complete the hosted connection, and select the accounts or properties Claude Code may use.
3. Start a session
Ask Claude Code to inspect live Meta Ads data. Writes stay staged until you approve them.
Capabilities
What Claude Code can do with NotFair
Read live Meta Ads data
Campaigns, ad sets, ads, spend, frequency, CPM, CTR, conversions, and audience overlap across Facebook and Instagram.
Counted tool surface
40 Meta Ads tools, measured from the production registrar and guarded by a drift test.
Hosted credentials
NotFair hosts the Meta Marketing API app. You authorize existing ad accounts through OAuth; you do not create a Meta developer app.
Platform-true writes
Preview the target and intended change, wait for explicit approval, then record operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on Meta. createAdImage uploads supplied PNG/JPEG assets. uploadAdVideo exists but production availability is gated behind a Graph API version and test-account canary.
Example workflows
Prompts that lead to real account work
Wasted-spend triage
“Audit my Meta Ads account for the last 30 days. Rank the three highest-cost problems with evidence. Do not change anything until I approve.”
A ranked diagnosis from live tools, with staged writes that wait for approval.
Creative or delivery review
“Show frequency, spend, and delivery for the active Meta Ads entities. Flag creative fatigue or stalled learning. Preview any pause.”
Platform-true delivery review. Preview the target and intended change, wait for explicit approval, then record operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on Meta.
Budget shift preview
“Propose moving budget from the worst entity to the best, showing current versus proposed values. Do not execute.”
An exact proposal you can approve or reject. NotFair does not claim Google Ads impact snapshots on this platform.
Why NotFair for Claude Code + Meta Ads
The hosted MCP endpoint is the same. The Meta Ads contract is not. NotFair keeps tool counts, OAuth, and write limits honest for this platform.
- 40 Meta Ads tools — not a vendor-wide total reused as a Meta Ads count
- NotFair hosts the Meta Marketing API app. You authorize existing ad accounts through OAuth; you do not create a Meta developer app.
- Preview the target and intended change, wait for explicit approval, then record operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on Meta.
- Same remote endpoint in Claude, Codex, Cursor, Windsurf, Gemini CLI, and OpenClaw
FAQ
Common questions about using Claude Code with Google Ads through NotFair.
Yes. NotFair's hosted MCP endpoint is the same across clients. Claude Code speaks MCP and can call the same tools. Meta publishes an official Ads MCP with paused-by-default writes.
NotFair does not copy Google Ads impact snapshots or undo onto Meta Ads. Preview the target and intended change, wait for explicit approval, then record operation provenance. NotFair does not expose Google Ads-style impact snapshots or undo on Meta.
NotFair advertises 40 Meta Ads tools.
Other integrations
Switching clients, or curious how this compares?
ChatGPT + Google Ads
NotFair connects ChatGPT to live Meta Ads through the same hosted MCP endpoint used across the product. Campaigns, ad sets, ads, spend, frequency, CPM, CTR, conversions, and audience overlap across Facebook and Instagram.
Cursor + Google Ads
NotFair connects Cursor to live Meta Ads through the same hosted MCP endpoint used across the product. Campaigns, ad sets, ads, spend, frequency, CPM, CTR, conversions, and audience overlap across Facebook and Instagram.
OpenAI Codex CLI + Google Ads
NotFair connects Codex to live Meta Ads through the same hosted MCP endpoint used across the product. Campaigns, ad sets, ads, spend, frequency, CPM, CTR, conversions, and audience overlap across Facebook and Instagram.