Meta Ads (Facebook Ads) connector for Claude

Use Porter’s Meta Ads connector for Claude to analyze Facebook and Instagram spend, ROAS and frequency, then pause ads, shift budgets and launch campaigns you approve.

  • Spot creative fatigue and pause the tired ads
  • Find the placements and audiences that convert cheapest
  • Pace budgets and move spend between campaigns
  • Compare Meta Ads with Google Ads and Shopify in one chat
Connect Meta Ads to Claude free See the 3 steps
G2★★★★★Rated 4.6/5 from 288 G2 reviews (October 2026) · Used by 1,600+ marketing teams and agencies

By Porter Metrics team · Last updated October 19, 2026

ClaudePorter connected
Rank my Meta Ads campaigns by Purchase ROAS for the last 7 full days and flag any campaign whose Cost per purchase rose more than 20%.
Porter / Meta Ads / Trailgear Demo✓ 4 rows
Retargeting – Carts leads at 5.8 Purchase ROAS. Prospecting – Video is the one to watch: Cost per purchase rose 27%.
CampaignPurchase ROASCost / purchase
Retargeting – Carts5.8$14.20
Advantage+ – Lookalike3.9$21.60
Prospecting – Video2.1$38.40
Brand – Reach1.4$52.10
Demo data, Trailgear Demo account
1,378 Meta Ads fields
01Setup

How to connect Meta Ads to Claude

Porter’s Meta Ads connector for Claude takes 3 steps and no code. Connect your ad accounts in Porter with Facebook Login, add Porter to Claude as a custom connector or plugin, then sign in and ask. Porter’s guide on how to connect Meta Ads to Claude also has screenshots, the Claude Code setup and the other free routes. MCP (Model Context Protocol) is the open standard Claude uses to connect to tools such as Porter.

Before you start

  • You need a Facebook user with a role on the ad account in Meta Business Manager, a free Porter account and any Claude plan. If a Facebook profile has no assigned ad account, it shows no accounts in Porter. In Meta’s ad account roles, Admins and Advertisers can create and edit ads while Analysts only view. Claude’s changes therefore need one of the first two.
  • Custom connectors work in Claude, Cowork and Claude Desktop on Free, Pro, Max, Team and Enterprise plans, but Free allows only one custom connector (Anthropic’s guide to custom connectors in Claude). The same Porter guide also covers Claude Code.
  • Works in Claude.ai, Claude Desktop, Cowork and Claude Code, with any Claude model, from Opus to Sonnet and Haiku.

  1. Step 1: Connect Meta Ads in Porter

    Sign up free at Porter, pick Meta Ads as the source and then sign in with Facebook. Tick every ad account you want Claude to read, then pick Claude as the destination.

  2. Step 2: Add the Meta Ads connector to Claude

    Then open Claude’s connector settings and add a custom connector called Porter Metrics with this URL. If you prefer, install the Porter plugin from portermetrics/porter instead:

    MCP URL
    https://mcp.portermetrics.com/mcp

  3. Step 3: Ask Claude about Meta Ads

    When Claude asks, log in to Porter, approve access and paste this prompt:

    Prompt
    Rank my Meta Ads campaigns by Purchase ROAS for the last 7 full days and flag any campaign whose Cost per purchase rose more than 20% versus the 7 days before.

Guides and videos

app.portermetrics.com / create
Porter's Select accounts window for Meta Ads with a demo account and the Connect button
First, in Porter, open Meta Ads and select Connect.
Porter's Facebook Ads authorization page with the authorized profile
Then, log in with Facebook and come back to Porter.
Claude's Add custom connector window with the name Porter Metrics and Porter's MCP URL filled in
Then, in Claude, add a custom connector with Porter's MCP URL.
Porter's Application Access Request screen asking you to let Claude use the Porter MCP server
When Claude asks, sign in to Porter and select Allow Access.
Porter Metrics listed as a connected connector in Claude with its read-only tools
After that, Porter shows as connected, so you can ask your first question.
If you prefer video, watch the whole Meta Ads to Claude setup (1:33, no sound).
Interactive walkthrough, so you can click along here
02Use cases and prompts

What you can ask Claude

Each use case comes with a prompt to copy, the fields it uses from the Meta Ads fields Claude can read and who it’s for. Every prompt uses fields that passed Porter’s tests.

Can Claude spot creative fatigue before it wastes spend?

The problemThe ad that won last month now costs more per purchase. But Ads Manager won’t call it fatigue until you line up frequency and CTR day by day.

What Claude doesClaude catches creative fatigue when it tracks frequency, link CTR and CPM per ad by day. Then it flags ads where frequency climbs while link CTR falls, shows each one’s mobile-feed preview and pauses the ones you pick.

What you getYou replace the day-by-day frequency check in Ads Manager, so tired ads come off before they push up cost per purchase.

Prompt
For the last 14 days, by Ad name and Date, show Amount spent, Impressions, Frequency, CTR (Link click-through rate), CPM (Cost per 1000 impressions) and Cost per purchase. Flag ads where Frequency rose above 3 while CTR (Link click-through rate) fell 3 days in a row.
Then ask
Prompt
Show the Ad preview URL: mobile feed for the flagged ads, then pause the 3 with the highest Amount spent after I confirm.

For: in-house media buyers · creative strategists · agencies

Fields used: Ad nameDateAmount spentImpressionsFrequencyCTR (Link click-through rate)CPM (Cost per 1000 impressions)Cost per purchasemobile feed
Action: ad_update (status)

Can Claude compare ROAS across attribution windows?

The problemYour store’s revenue says one ROAS while Ads Manager says another. Part of the gap is due to the attribution window each ad set reports on.

What Claude doesFor each ad set, Claude shows the default window (the ad set’s own setting, as in Ads Manager). Then it puts 1-day click, 7-day click and 1-day click + 1-day view next to it, and names the window behind each number.

What you getYou can tell a real ROAS drop from a window difference before you cut a budget.

Prompt
For each ad set in the last 30 days, show Adset name, Attribution setting, Purchases, Purchases (7 days click), Purchases (1d_click + 1d_view), Purchase ROAS (Return on ad spend), Purchase ROAS (Return on ad spend) (1 day click), Purchase ROAS (Return on ad spend) (7 days click) and Purchase ROAS (Return on ad spend) (1d_click + 1d_view). Don't add up ad sets with different Attribution settings.

For: e-commerce marketers · marketing analysts · agencies

Fields used: Adset nameAttribution settingPurchasesPurchases (7 days click)Purchases (1d_click + 1d_view)Purchase ROAS (Return on ad spend)Purchase ROAS (Return on ad spend) (1 day click)Purchase ROAS (Return on ad spend) (7 days click)Purchase ROAS (Return on ad spend) (1d_click + 1d_view)

Can Claude find the placements and audiences that convert cheapest?

The problemAdvantage+ placements spread your budget across Feeds, Stories, Reels and Audience Network, but you can’t see which ones bring the purchases.

What Claude doesClaude ranks cost per purchase and ROAS by platform and position, then by age and gender in a second query. That’s because Meta allows one breakdown family per query. It can also drop a placement from an ad set or narrow its age range.

What you getOne answer replaces two breakdown exports, so you move budget or cut a placement based on numbers you can see.

Prompt
For the last 30 days, show Amount spent, Purchases, Cost per purchase and Purchase ROAS (Return on ad spend) by Publisher platform and Platform position. Then, in a separate query, show the same metrics by Age and Gender. Where should more budget go?
Then ask
Prompt
Remove Audience Network from the placements of ad set {name} after I confirm.

For: in-house media buyers · e-commerce marketers · agencies

Fields used: Publisher platformPlatform positionAgeGenderAmount spentPurchasesCost per purchasePurchase ROAS (Return on ad spend)
Action: adset_update (placements, age)

Can Claude pace budgets and move spend between campaigns?

The problemHalfway through the month, one campaign is running out of budget while another barely spends.

What Claude doesClaude compares spend with daily, lifetime and remaining budget at campaign and ad set level, then ranks each by cost per purchase. After that, it proposes new budgets in your account currency and applies the ones you choose.

What you getThe pacing sheet you rebuild every week becomes one question, while the budget shift happens in the same chat.

Prompt
For active campaigns this month, show Campaign name, Campaign daily budget, Campaign lifetime budget, Campaign budget remaining, Amount spent, Purchases and Cost per purchase. For ad sets with their own budget, show Adset name, Adset daily budget and Adset budget remaining. Which will run out early and which are under-spending?
Then ask
Prompt
Move 20% of the daily budget from the campaign with the highest Cost per purchase to the one with the lowest. Show me the change first.

For: in-house media buyers · agencies

Fields used: Campaign nameCampaign statusCampaign daily budgetCampaign lifetime budgetCampaign budget remainingAdset nameAdset daily budgetAdset budget remainingAmount spentPurchasesCost per purchase
Actions: campaign_update · adset_update

Can Claude launch a campaign from a brief?

The problemA new campaign still means hunting down Page and pixel IDs, uploading creatives and clicking through every level of Ads Manager.

What Claude doesClaude finds your Page, pixel and targeting IDs before it uploads the image or video. Then it builds the campaign, ad set and ad for you to review. Meta locks the objective and optimization goal once a campaign exists, so set both in your first prompt.

What you getYou review a finished draft instead of building it field by field.

Prompt
Find my Page and pixel, then create a paused Sales campaign optimizing for website purchases with a $50 daily budget, one ad set for women 25–44 in the United States on Facebook and Instagram, and one ad using the image at {URL} with this primary text and headline: {text}.
Then ask
Prompt
Create a 1% lookalike in the United States from my purchasers custom audience and add it to a second paused ad set.

For: in-house media buyers · agencies · e-commerce marketers

Actions: page_list · pixel_list · geolocation_search · interest_search · image_upload · video_upload · campaign_create · adset_create · ad_create · lookalike_create

Can Claude build one weekly report across all my Meta Ads accounts?

The problemEvery Monday, someone clicks between client ad accounts in Business Manager, then copies the same columns into one sheet.

What Claude doesClaude queries every connected ad account in one request, compares exact date ranges, converts spend to one currency and then drafts a summary per client. It uses Amount spent rather than Account amount spent, which repeats the lifetime total on every row.

What you getAccount switching and copy-paste drop out, so each client email starts from the accounts that actually moved.

Prompt
For every Meta ad account I've connected, show Account name, Account ID, Amount spent (USD), Purchases, Cost per purchase and Purchase ROAS (Return on ad spend) for {Monday date}–{Sunday date} versus the 7 days before. Flag accounts where Cost per purchase rose more than 20%.
Then ask
Prompt
Write a 3-line summary per flagged account I can paste into a client email.

For: agencies · freelancers

Fields used: Account nameAccount IDDateAmount spent (USD)PurchasesCost per purchasePurchase ROAS (Return on ad spend)

Can Claude analyze competitors' ads in the Meta Ad Library?

The problemA competitor floods your feed with new ads, but scrolling the Ad Library one creative at a time tells you little about what they’re testing.

What Claude doesClaude pulls any brand’s live ads from the public Ad Library, then groups duplicates by creative. It also transcribes the videos and sorts hooks and angles into a hosted report. The Ad Library is public, so this works without an ad account.

What you getYou get a competitor’s hooks and angles for your next creative brief instead of scrolling the library ad by ad.

Prompt
Pull the live Meta ads of {brand} from the Ad Library, group them by unique creative, transcribe the videos and list the hooks and angles they use most. Publish it as a report.

For: creative strategists · agencies · e-commerce marketers

Fields used: Competitor creative analytics comes with the Scale plan.
Actions: meta_ads_research.run_audit · enrich_creatives · view_creative · publish_report

Can Claude report Meta lead ads by cost per lead?

The problemLead campaigns keep filling forms, but comparing CPL by ad means one report in Ads Manager and another trip to the Page’s lead forms.

What Claude doesClaude ranks campaigns and ads by leads and CPL, and also lists the lead forms on your Page. Pass a Page access token in the chat and Claude reads the submitted leads too.

What you getYou see which campaigns and ads bring the cheapest leads before you raise their budgets.

Prompt
For the last 30 days, show Campaign name, Ad name, Leads and CPL (Cost per lead), sorted by CPL. Then list the lead forms on my Page.

For: B2B marketers · lead gen marketers · agencies

Fields used: Campaign nameAd nameLeadsCPL (Cost per lead)
Actions: leadform_list · lead_list
03Why Porter

Why Porter for Meta Ads in Claude

Porter reads any ad account your Facebook user can reach, next to the rest of your marketing data. If Meta has enabled your ad account and you only need Meta, including catalog ads, A/B tests and signal diagnostics, Meta’s official Ads AI connector fits well (Meta’s Ads MCP server docs). You can run both.

✓

1,378 ready-made fields

Claude reads 1,378 fields, from account down to ad and creative, across every ad account where your Facebook user has a role. Meta doesn’t need to enable anything first.

⊞

Changes only after you approve

Claude pauses ads, moves budgets and builds campaigns, ad sets, ads and audiences through 32 actions, asking before every change. New campaigns start paused, and large budgets need an extra confirmation.

⚙

Meta Ads next to Google Ads and Shopify

Compare Meta Ads with the Google Ads connector for Claude or the Shopify connector for Claude in the same chat, so ROAS meets the rest of your marketing data.

Aa

37 months of history, live

Meta keeps 37 months of daily delivery, cost and conversion data. On paid plans Porter queries that full window live, today included, so Claude compares this month with the same month two years back.

↻

Ad Library teardowns and new creatives

Claude pulls any brand’s live ads from the Ad Library and sorts their hooks and angles. Porter also generates ad images and videos that Claude uploads to a new ad.

✓

One connection, every destination

Sign in with Facebook once. The same ad accounts also feed ChatGPT through Porter’s MCP server for any MCP client, Data Studio and BigQuery (Meta Ads to BigQuery connector).

⊞

Live dashboards, not only chat answers

Ask Claude for a dashboard and Porter’s AI dashboards publish it at its own link, synced automatically and ready to share. Official MCP servers answer inside the chat and stop there.

04Dashboard

Dashboard template

If your team reviews ads together, you can skip the chat: Porter fills the free Facebook Ads Dashboard template in Data Studio (formerly Looker Studio). It charts impressions, clicks, Amount spent, CPC and CTR by campaign, ad set and ad, since Porter’s Meta Ads to Data Studio connector feeds it.

AI dashboards

Build a live Meta Ads dashboard from the chat

Describe the dashboard in one sentence and Porter builds it. A client-ready dashboard in minutes, with no chart dragging and no BI tool to learn. Ask Claude:

Prompt
Build a live Meta Ads dashboard for my account with the last 30 days, the main KPIs and a weekly trend.
Live URLEach dashboard at its own link: no login, no app, no download
Auto-syncFresh Meta Ads data, nobody re-exports each period
Scheduled deliveryEmail or PDF sends on a set day
White labelYour logo and branding for clients
Sharing permissionsView or edit access per person
Meta Ads AI dashboard template built with Porter Metrics AI dashboards
Template

The Meta Ads AI dashboard template

Built with Porter's AI dashboards on a real account. Open it live, then ask Claude to make one like it for your account.

Open the live Meta Ads dashboard

→Meta Ads dashboard templates ↗Ready-made layouts for Meta AdsDashboard templates for every source ↗Ads, social, SEO, ecommerce and CRMPorter's template gallery ↗Every Porter template in one place
05Pricing

Pricing

You can start free, since Porter’s Meta Ads connector for Claude comes with every plan. Use the calculator for your number of accounts, or see Porter pricing for every plan.

What you get

  • Free plan: never expires, with unlimited connected accounts and the last 15 days of data in Claude (30 days in Data Studio and Sheets)
  • Reporting: from $12.50 per account a month billed annually, or $15 month to month for one account
  • Billing: each Meta ad account counts as one account, with volume discounts and no per-seat fee
  • Changes: 1 AI credit per completed change; failed tasks are free, and the Free plan includes 100 credits a month
  • Trial: 14 days of full access, no card

See full pricing and plans

Price calculator

$33.33/mo$6.67 per account

An account is one ad account, Stripe account, store, page or GA4 property. The Free plan never expires and has unlimited accounts, with the last 15 days of data in AI chats.

Start free
06Data and actions

Meta Ads data and actions in Claude

The Meta Ads connector gives Claude 1,378 fields, including 167 dimensions, from account down to ad and creative. Porter also gives Claude 32 actions to read and change the account. Most questions need only the 12 fields below, while the Meta Ads fields list has every label and id.

The 12 Meta Ads fields Claude uses most

FieldWhat it's for
Amount spentspendSpend in the account currency for the period
Purchase ROAS (Return on ad spend)purchase_roas_purchaseROAS on each ad set's own attribution setting
Cost per purchasecost_per_purchaseCPA for purchase campaigns
PurchasespurchasePurchases on the ad set's attribution setting
Purchase conversion valuevalue_omni_purchaseRevenue Meta attributes to ads
FrequencyfrequencyAverage times each person saw an ad; a fatigue signal
CTR (Link click-through rate)inline_link_click_ctrLink clicks per impression
CPM (Cost per 1000 impressions)cpmCost of reach by audience or placement
Publisher platformpublisher_platformFacebook, Instagram, Audience Network, Messenger or Threads
Attribution settingattribution_settingWhich window an ad set reports on
Campaign budget remainingcampaign_budget_remainingPacing for campaign budgets
Ad preview URL: mobile feedad_mobile_feed_preview_urlThe creative behind the numbers

Can Claude pause, edit or create Meta Ads campaigns?

Yes. Claude pauses, edits, creates and deletes campaigns, ad sets, ads, audiences and lead forms. Deletes are permanent, so check each one before you approve it.

TypeCountExamples
Read14Campaigns, ad sets, ads, any object by ID, audiences, pixels, custom conversions, Pages, lead forms, leads, interest and location search
Create9Campaigns, ad sets, ads, image and video uploads, custom audiences and customer lists, lookalikes, lead forms
Update5Campaign, ad set and ad status, budget, bid, schedule, targeting, placements, creative; audiences; lead forms
Delete4Campaigns with their ad sets and ads, ad sets, ads, audiences

How far back can Claude read Meta Ads data?

Meta serves ads insights for up to 37 months, per Meta's 37-month reporting limit. Paid Porter plans read everything Meta returns, while the Free plan reads the last 15 days in Claude (30 days in Data Studio and Sheets).

Product stats

WhatMeta Ads connector
Fields1,378 (167 dimensions), from account down to ad and creative
Actions32 (14 read, 9 create, 5 update, 4 delete)
FreshnessLive query to Meta on each question, today included
HistoryUp to 37 months on paid plans; the last 15 days in Claude on the Free plan (30 days in Data Studio and Sheets)
Attribution windowsDefault, 1-day click, 7-day click, 28-day click and 1-day click + 1-day view
Rate limitsMeta's Insights cap: 600 calls per ad account per hour on the Dev tier, 190,000 with full Ads API access
AccessFacebook Login on the ad accounts you tick; changes need an Admin or Advertiser role

See all 1,378 Meta Ads fields

07Security

Is it safe?

Yes, the Meta Ads connector for Claude signs in with Facebook Login, so Porter reaches only the ad accounts you tick. Deleting a campaign, ad set, ad or audience is permanent, so check each delete before you approve it.

What the connector needs from Meta Ads

Meta ties each task to a permission: ads_read for reports, ads_management for changes and leads_retrieval for lead forms, as Meta's Marketing API permissions list them. Porter then reads and writes only on the ad accounts you tick at sign-in, and you can revoke its access anytime.

How you approve changes

New campaigns and creatives are created paused, and Porter asks before writing anything, so nothing delivers until you turn it on. Large budgets also need an extra confirmation.

Status, budget and targeting changes can be reverted with another change. However, deleting a campaign also deletes its ad sets and ads. Each completed change uses 1 AI credit.

Will Meta ban my ad account for using an MCP?

No. Meta says "it's unlikely that an account would be banned simply for using" its ads MCP (Meta's guidance on connecting the ads MCP safely). Porter calls the same Marketing API through Facebook Login, while Porter's guide on Meta Ads ban risk covers what does get ad accounts disabled.

Instead, the real limit is Meta's rate limit (Meta Marketing API rate limits). Insights calls per ad account per hour cap at 600 on Meta's Dev tier, compared to 190,000 with full Ads API access. In addition, you get 400 per active ad.

08FAQ

FAQ

These answers cover Instagram, Facebook Pages, custom conversions, live data and ChatGPT. The last three help when numbers or queries look wrong in Claude, and Porter's setup tutorial also has more fixes.

Does the Meta Ads connector include Instagram ads?

Yes, Instagram ads run through Meta Ads, so Claude reads them alongside Facebook, Audience Network, Messenger and Threads. Split results by Publisher platform, then by Platform position for feed, Stories and Reels, and compare cost per purchase across them.

Is the Meta Ads connector the same as the Facebook Pages connector?

No. The Meta Ads connector brings paid Facebook and Instagram campaigns, also called Facebook Ads, into Claude. Organic Page posts, reach and followers, however, come from Porter's Facebook Pages connector for Claude.

If you connect both in Porter, you can compare paid and organic results in one chat.

Can Claude read my custom conversions?

Yes, Claude lists the custom conversions in your ad account, then reads Cost per website custom conversion next to campaigns, ad sets and ads. You can rank them by cost the way you rank purchases, then compare them across campaigns in one prompt.

Is Meta Ads data in Claude live?

Yes, because Porter stores no Meta Ads data, each question queries Meta live, including today's partial day. Meta refreshes insights about every 15 minutes and stops changing them after 28 days (Meta's insights refresh schedule), so recent days can move between questions.

Can I use Porter in ChatGPT too?

Yes. The MCP behind the Meta Ads connector for Claude also works in ChatGPT. If your team uses both, you can then ask about the same campaigns in either one. If you need setup help, follow Porter's guide to connect Meta Ads to ChatGPT, which walks through each ChatGPT screen.

Troubleshooting

Why don't Claude's numbers match Ads Manager?

Claude's numbers can drift from Ads Manager because of mixed settings. Purchases and ROAS follow each ad set's own attribution setting, so an account total adds windows together (Meta's guide to multiple attribution settings).

Compare 7-day click in Claude with 7-day click in Ads Manager, and ask for exact dates, since presets use UTC. Also, reach can't be summed across rows.

Why does Claude say "The remote connector reported an error"?

Claude shows that error when Porter's query breaks a Meta Ads rule and Meta sends back no reason. One usual cause is two breakdown families at once, such as Age with Publisher platform or Country code. The others are any DMA breakdown, or a date range older than Meta keeps. In that case, ask again with one breakdown per query or a shorter range.

Why does Claude list my ad accounts but return no data?

Claude lists ad accounts but returns no data when the Facebook consent screen closed before the ad account was ticked. Then every query asks you to reconnect. In that case, reconnect Meta Ads in Porter and tick each account. If one still shows nothing, check that your Facebook user has a role on it in Business Manager.

09Next

More Claude connectors

Claude reads more than Meta Ads through Porter, and the same Meta Ads connection also feeds Porter's other destinations. Browse all Claude connectors or pick another ad platform below, since each page lists that platform's prompts, fields and limits.

→TikTok Ads connector for Claude→LinkedIn Ads MCP for Claude→Microsoft Ads connector for Claude→google-ads connector for Claude→Pinterest Ads connector for Claude

Not only Claude. Send Meta Ads data anywhere

The same Porter account and connection also send Meta Ads data to these destinations, at no extra cost.

→Meta Ads to ChatGPT→Meta Ads to Data Studio→Meta Ads to Google Sheets→Meta Ads to BigQuery→Meta Ads connector for any AI tool (MCP)

Try the connector in Claude

Porter's Meta Ads connector for Claude takes 3 steps, so your first question can go out today. For example, ask Claude to catch tired creatives, find the placements that convert cheapest or draft a new campaign for review. Then decide what to change in the same chat.

Connect Meta Ads to Claude free

Free plan · 14-day trial · No card needed

In-house media buyers: creative fatigue, placement costs and pacing get checked, then fixed, in one chat.

Agencies: the Monday roll-up across client ad accounts takes one prompt, including competitor teardowns.

E-commerce marketers: budget moves rest on ROAS from the attribution window you trust.

About the author: Porter Metrics team. The team builds Porter's marketing data connectors and tests every prompt on this page.Last updated October 19, 2026

Automate marketing reporting and analysis with AI like it's 2026.

LinkedIn YouTube TikTok
G2 Momentum Leader Badge - Porter Metrics rated 4.6 out of 5 stars G2 Best Estimated ROI Badge - Porter Metrics G2 Best Relationship Badge - Porter Metrics

Destinations

Data Warehouse

Reporting

Alerts & Notifications

  • Slack iconSlack
  • Zapier iconZapier

Chat

  • Claude AI iconClaude
  • Google Gemini iconGemini
  • ChatGPT iconChatGPT

Connectors

Templates

Resources

© 2026 Porter Metrics. All rights reserved.