How to Connect Claude to Meta Ads
Metrifact connects Claude to your Meta Ads account so you can ask questions in plain English and get answers pulled from live account data. Setup takes about two minutes: no API key, no code, just an OAuth login through Facebook. Claude finds the problem: an ad whose frequency spiked while its CTR collapsed, an ad set spending real money with nothing to show for it. Metrifact applies the fix once you’ve confirmed it in the conversation. Nothing changes on its own.
Connect Claude to Metrifact
No API key needed. OAuth handles login and account access entirely inside Claude.
Remote server URL
https://app.metrifact.com/mcp What you’ll need
- A Meta ad account you have admin access to. Business Manager-owned or under a personal login both work
- Claude.ai or Claude Desktop
- About two minutes. No API key, no code to write
Note
Connecting grants Claude the same access level your Facebook login already has on that ad account. Reading data works immediately: campaigns, ad sets, ads, spend, all of it. Write actions, like pausing an ad or changing a budget, still need your explicit confirmation in the conversation before anything is applied. Connecting the account is not the same as handing over blanket write access.
Connect Claude to Meta Ads
Every connection uses Facebook’s own OAuth flow. You log in directly with Facebook, not with Metrifact. Metrifact never stores your Facebook password. What comes back is a scoped access token, not your credentials.
-
Open Settings, then Connectors
Inside Claude, go to Settings and select Connectors.
-
Choose Add custom connector
This opens the form where you’ll paste Metrifact’s connector URL.
-
Paste the URL below, then select Add
Use
https://app.metrifact.com/mcpas the connector URL. -
Log in and approve access
Claude opens an authorization window. Log in with Facebook, then approve access to continue.
Once you’re back in Claude, ask it to list your connected accounts before doing anything else. That confirms the right one made it through the connection.
If your Facebook login sits inside a Business Manager, you’ll likely see more than one ad account to choose from during setup, not just the one you had in mind. That’s expected, not an error. It’s covered in more detail in the troubleshooting section below.
One honest limit worth stating plainly: Meta’s access token isn’t permanent the way Google’s is. Using the connection at all keeps it alive indefinitely, since Metrifact quietly renews it in the background before it expires. Go completely dormant on Meta Ads for about two months and the token lapses, and you’ll need to reconnect. Metrifact emails you when that happens rather than letting a tool call just fail with no explanation.
If you also run Google Ads, the setup is nearly identical: see How to Connect Claude to Google Ads.
Analyze your account
Find the ads where frequency has climbed above 3 in the last 14 days while CTR has dropped by half or more.
Show me every ad set that’s spent more than $500 in the last 30 days with no conversions.
Compare targeting across my active ad sets and tell me if any of them are targeting the same custom audience.
Show me performance broken down by placement for this campaign over the last 30 days.
The audience overlap check isn’t a dedicated Meta report. Claude pulls each ad set’s targeting and compares them directly. It’s the same comparison you’d do by hand across a dozen browser tabs, just faster.
If these numbers don’t match Shopify’s or GA4’s for the same period, that’s expected, not a bug: see Stop trusting platform-reported ROAS. Use MER. for why, and what to check instead.
How changes are approved
Note
When you ask Claude to make a change, Metrifact prepares the exact edit and shows it to you before touching your account. You confirm it in the conversation, and then it’s applied. Nothing runs silently. A budget increase of more than 3x an ad set’s current value needs a separate, explicit acknowledgment on top of the normal confirmation, so a misread instruction can’t quietly triple your spend. That confirmation is also short-lived. If you walk away mid-conversation, you’ll need to ask again once you’re back.
Meta itself allows up to 4 budget edits on the same ad set within an hour. Metrifact caps you at 2. That’s not caution for its own sake: every budget edit risks restarting an ad set’s learning phase, the window where Meta’s delivery system is still figuring out who to actually show your ad to. Reset it too often and the ad set never leaves that phase. Delivery gets worse, not better, and cost per result climbs while it’s stuck relearning. Try a third budget edit on the same ad set inside an hour and Metrifact refuses the change outright, even if you’re certain you want it. It tells you how long to wait instead.
Act on what you find
Pause those ads.
Cut that ad set’s daily budget from $150 to $60.
Exclude that audience from the newer ad set.
Turn off Audience Network for this ad set.
Notice the prompts don’t repeat the ad set, ad, or audience names. Claude already has them from the conversation above.
Every one of these still goes through the same preview-then-confirm step described above.
Troubleshooting
My ad account isn't showing up after I connected
If your Facebook login has access to more than one Business Manager, or more than one ad account inside one, Metrifact lists every account that login can reach and lets you pick which to connect. If the account you wanted isn’t in that list, you’re logged into a different Facebook account or Business Manager than the one that actually owns it. Log out of Facebook and reconnect with the right login.
A budget edit got rejected
Metrifact caps budget edits at 2 per ad set per hour, under Meta’s own 4-per-hour limit. If you hit that cap, the response tells you exactly how many edits you’ve already made and how long to wait. Nothing about the account is broken. Space the changes out instead of retrying immediately.
Claude says it can't find my Facebook Page, or the page list comes back empty
This is almost always a missing permission, not an empty account. Facebook returns an empty list rather than an error when a page-related permission wasn’t granted during connection, which looks identical to “you have no Pages” unless you already know to check. Disconnect and reconnect, and approve every permission Facebook’s OAuth screen asks for rather than skipping the ones that look optional.
My confirmation expired before I approved it
Confirmations are short-lived on purpose, so a change can’t sit half-approved indefinitely. Ask Claude to prepare the change again and confirm it right away. Nothing from the expired attempt carries over.
The OAuth window closed without finishing login
This is usually a pop-up blocker. Allow pop-ups for claude.ai and try connecting again. If it still doesn’t open, check that you’re not already signed into a different Facebook account in the same browser session.
Claude says it can't do something I know Metrifact supports
Claude reads the list of available tools once, when it connects, not on every message. If we ship a new capability after your session connected, that session keeps using the list it started with. The fix is live on our end. Disconnect Metrifact in your account settings and reconnect to pick it up. One reconnect doesn’t always take effect right away, so if the capability still isn’t there, disconnect and reconnect again rather than assuming something’s wrong.
FAQ
Do I need to install anything to connect Claude to Meta Ads?
No. Metrifact is hosted, so you paste a URL into Claude and sign in. There’s no server to run and nothing to keep updated on your end.
Is my Meta Ads data used to train any AI model?
No. Your account data is retrieved live for each request, not copied into a separate database of its own, and never sold, shared with third parties, or used to train any AI or ML model.
Can Claude change my campaigns without asking me first?
No. Every write action goes through a preview step first, and nothing is applied until you explicitly confirm it in the conversation. That confirmation also expires automatically after a short window if you don’t use it, so it can’t sit around waiting.
Can I connect through a Business Manager, or do I need a personal login?
Either works. Metrifact lists every ad account your login can access, Business Manager-owned or personal, and lets you pick which ones to actually connect.
Will connecting Metrifact get my ad account flagged or restricted?
Metrifact only uses Meta’s own official Marketing API, the same access model any approved third-party tool uses, paced under internal limits set below what Meta allows specifically to avoid tripping automated abuse detection. It never asks for your password and can’t bypass Meta’s own account policies.
Can I connect accounts for multiple clients if I run an agency?
Yes. Connect using your own login and each client account you have access to shows up in your workspace. If a client would rather not hand you their login, they can connect their own account instead and share access with you that way. Removing a connection later deletes its stored credential immediately, not on some delayed schedule.
Try it on your own accounts
Connect Google Ads, Meta, GA4, Search Console and Shopify to Claude in two minutes. 7-day trial, no card.
Start free trial