How to Connect Meta Ads (Facebook) to Claude (Direct Connector)

Do you want to create Facebook Ads performance reports like this, powered by Windsor.ai’s direct connector for Claude?

Claude can instantly turn raw performance data into clear, actionable insights, but only if it has access to your ad metrics. The issue is that spend, ROAS, conversions, and other KPIs stay locked inside Meta Ads Manager unless you move them into your AI chat.
The typical workaround? Download a CSV, clean the formatting, upload it to Claude, then repeat the entire process when you need fresh numbers. That approach breaks down fast when you’re managing multiple accounts or tracking campaigns that shift daily.
Windsor.ai direct connector (MCP) changes the game. It connects Facebook Ads directly to Claude through the Meta Marketing API, giving your AI agent live access to 560+ metrics and 150+ dimensions without a single manual export. Stream your data automatically and start asking Claude about your campaign performance. It answers instantly with your actual data—current, structured, and ready to act on.
🚀 Get started with Facebook Ads → Claude (30-day free trial): https://onboard.windsor.ai/.
This guide shows you how to build Facebook Ads-to-Claude integration in less than 60 seconds.
Send Facebook Ads data to Claude in 3 steps
The connection between your Meta Ads account and Claude happens in three quick moves: link your Facebook Ads account to Windsor.ai, add the Windsor.ai connector in Claude, and start querying your data.
📖 Follow our quick step-by-step guide to automatically integrate your data into Claude.
What you’ll need
- A Windsor.ai account (free trial or paid plan)
- Facebook/Meta Ads account with view or admin access
- Claude account
Step 1: Connect your Facebook Ads account(s) to Windsor.ai
To link your data, first, you have to authenticate your Meta Ads Manager through the Windsor.ai onboarding portal.
- Head to onboard.windsor.ai, sign in, and add Facebook Ads as your data source.
- Select the account(s) that you’d like to connect to Claude for analysis.

Windsor pulls data directly from the Meta Ads API, normalizing it in the background so Claude gets clean, structured datasets instead of raw export files.
Once connected, Windsor maintains a live pipeline from your ad account to Claude. The data stays current without any manual refresh.
Step 2: Add the Windsor.ai connector in Claude
With your data flowing into Windsor, the next step is to send Facebook Ads data to Claude by adding the Windsor.ai connector for Claude.
- Just open this Windsor.ai connector page and click Connect.

- You will be prompted to authorize the connection. Select “Always allow” to avoid repeated permission prompts.

Windsor MCP now appears in your active connectors. Open a new Claude chat to start querying your Facebook Ads data.
Step 3: Start querying your Facebook Ads data in Claude
With the connection live, you can ask Claude about your ad performance using plain language. Instead of navigating Ads Manager or building dashboards, you tell Claude what you want to know and get strategic answers based on your real Meta Ads data.
Try these sample prompts:
- “Show ROAS by campaign for the last 30 days and highlight campaigns below 2.0.”
- “Which ad sets had the highest CPA last week?”
- “Compare spend, conversions, and CPA this month vs. last month and suggest budget reallocation.”
💡 Pro tip: Mastering attribution in Claude
When querying your data, always specify your attribution window (e.g., “Show me 7-day click vs. 1-day view conversions”).
Because Windsor.ai pulls raw Meta Marketing API data, Claude can help you identify “hidden” conversion value that the standard Ads Manager UI often over-simplifies. This allows you to see exactly how many users saw an ad and converted later, even if they didn’t click immediately.
Prompt ideas that unlock deeper Facebook Ads insights
Once your data is connected, Claude becomes more than a chatbot; it’s a professional analyst that knows your campaigns.
The prompts below show how agencies, B2B marketers, and e-commerce teams use Windsor MCP to extract insights that used to require SQL queries or manual spreadsheet work.
🤖 For more advanced prompt ideas across Facebook Ads and other data sources, browse the full Windsor AI Prompt Library.
Are you an agency? Use Claude for multi-account analysis and client reporting
Managing multiple Facebook Ads accounts means juggling logins, exports, and client reports. Windsor MCP lets you analyze performance across every account you manage from a single Claude interface.
Create a weekly client performance summary
Create a weekly performance summary for each Facebook Ads account. Include spend, conversions, CPA, ROAS, and highlight the biggest performance changes vs last week. Add a short explanation of what likely caused the change.
Identify underperforming campaigns across accounts
Across all connected Facebook Ads accounts, list campaigns where CPA increased by more than 25% in the last 14 days. Explain possible causes and recommend optimization actions.
Get budget reallocation recommendations
Analyze campaign-level ROAS across all accounts for the last 30 days. Suggest how to reallocate budgets to maximize overall return on ad spend. Highlight campaigns that should receive more budget.
Perform multi-account benchmarking
Compare Facebook Ads performance across all accounts by industry segment. Which accounts have the lowest CPA and highest ROAS? Identify patterns in targeting, creatives, or placements that might explain the differences.
Prompt idea for monthly ROAS analysis
Show ROAS by campaign for the last 30 days. Which campaigns are underperforming vs my target, and what are the likely reasons?Identify creative fatigue
Analyze my Facebook Ads by 'Frequency' and 'CTR' for the last 14 days. List any ads where frequency is above 3.0 but CTR has dropped by 20% compared to the previous week.
Detect a budget leak
Review all active campaigns. Identify any that have spent more than 2x the target CPA in the last 48 hours without a single conversion.
Review weekly CPA
Break down spend and results by ad set for this week. Which ad sets have the lowest CPA, and which ones should I pause or optimize?Cover creative performance analysis
Which creatives had the highest CTR last month, and how did they perform in terms of conversions?Run month-over-month comparison
Compare campaign performance this month vs last month across spend, ROAS, and CPA. Highlight the biggest drivers of change.Define high-performing audience segments
Break down performance by audience segment (geo, age, gender, placement, device). Which segments drive the most conversions at the lowest cost?Are you a B2B marketer? Estimate cost per qualified lead and pipeline impact
For B2B teams, Facebook Ads performance isn’t measured in clicks or even conversions. It’s measured in qualified leads, opportunities, and closed revenue.
When Windsor combines Facebook Ads with CRM data from HubSpot or Salesforce, Claude can analyze the full funnel.
Calculate cost per qualified lead
Using CRM data, calculate the cost per qualified lead by Facebook campaign for the last 30 days. Identify campaigns producing the highest number of qualified leads.
Analyze pipeline attribution
Match Facebook campaign data with CRM opportunities using UTM parameters. Which campaigns generated the highest total pipeline value?
Evaluate lead quality
Compare Facebook campaigns by lead-to-opportunity conversion rate. Which campaigns generate the highest quality leads?
Analyze sales cycles
Analyze whether leads generated from Facebook Ads close faster or slower than leads from other channels. Break down results by campaign.
Are you an e-commerce marketer? Analyze ROAS and revenue drivers
E-commerce teams want to know which campaigns drive revenue, which products perform best, and where to scale spend.
Windsor MCP connects Facebook Ads with Shopify, WooCommerce, or other e-commerce platforms so Claude can analyze ad spend against real revenue.
Calculate campaign-level ROAS
Match Facebook Ads campaign data with Shopify revenue using UTM campaign parameters. Calculate ROAS by campaign for the last 30 days. Highlight campaigns with ROAS below 2 and suggest optimization ideas.
Identify wasted ad spend
List campaigns where the spend increased but the revenue decreased over the last 14 days. Explain what might be causing the inefficiency.
Estimate product-level performance
Which products generated the most revenue from Facebook Ads campaigns last month? Break down results by campaign and ad set.
Define scaling opportunities
Identify campaigns with ROAS above 4 and stable CPA. Recommend which campaigns could be scaled safely.
Cross-channel analysis: Combine Facebook Ads with revenue, CRM, and analytics data
Facebook Ads data alone rarely tells the full story. The value appears when you combine ad data with business outcomes.
Because Windsor connects 325+ data sources, Claude can analyze Meta Ads alongside:
- Shopify or e-commerce revenue
- CRM opportunities and closed deals from HubSpot or Salesforce
- GA4 conversion data
- Ad performance from Google Ads, LinkedIn, TikTok
Calculate blended ROAS across channels
Combine Facebook Ads spend with Shopify revenue and GA4 conversions. Which campaigns generate the highest blended ROAS across all channels?
Calculate the B2B closed deal cost
Combine Facebook Ads campaigns with CRM deal data. Show cost per closed deal by campaign.
These questions previously required data warehouses or BI dashboards. With Windsor MCP, you ask Claude and get AI-driven analysis in seconds.
Facebook Ads data available in Claude via Windsor MCP
Windsor MCP gives Claude access to a comprehensive Facebook Ads schema covering 560+ metrics and 150+ dimensions across all reporting levels.
The data comes directly from the Meta Marketing API, so you can analyze performance at any level of detail.
Core reporting levels
Account level
- account_id, account_name, currency, account_status
Campaign level
- campaign_name, campaign_id, campaign_objective, campaign_status
Ad set level
- adset_name, adset_id, optimization_goal, billing_event, targeting parameters
Ad and creative level
- ad_id, ad_name, creative_id, creative_name
Performance metrics
- spend, impressions, clicks, link_clicks
- CTR, CPC, CPM
- conversions, purchases, leads, add_to_cart, landing_page_views
- purchase_value, ROAS, cost_per_conversion
Audience breakdowns
- age, gender, device, placement, country
💡 Good to know: Unlike standard ETL tools that send data to a static sheet, the Windsor MCP creates a live conversational bridge. This means Claude understands the schema of your Facebook Ads, so you don’t have to explain what ‘Spend’ or ‘ROAS’ means every time you start a new chat.
What you can do once Facebook Ads data is in Claude
Below are the most common ways performance marketers use this integration.
✨ For a full walkthrough of what is possible, explore the Windsor MCP use cases guide.
1. Generate the output in any format
One of the biggest benefits of automated Facebook Ads reporting in Claude is that Claude can return results in whatever format you need, whether that’s a short summary, a table, or a client-ready report, including:
- Daily, weekly, or monthly performance summaries written in plain language
- Tables and CSV-ready outputs you can drop straight into a report
- Cross-account comparisons across all your active campaigns
- Client-ready visual dashboards and insights generated on demand
- Action plans with specific optimization recommendations based on your data
2. Create client reports
For agencies, the ability to connect multiple Facebook Ads accounts to Claude and generate reports across clients is where Windsor stands out. You can analyze your entire client roster without extra setup.
💡 Tip: You can ask Claude to filter your dataset by account ID or account name right inside your prompts to handle your entire client roster without any extra setup.
To add specific account or property IDs in your MCP query, try the following sample prompt (replace with your account details):
Use the Windsor.ai MCP to analyze how Facebook Ads impacts overall business conversions this month. Only use the following accounts: - facebook_ads_account_id: 1234567890, 9876543210 Provide insights into causation and correlation across these accounts.
That is the beauty of marketing data to Claude automation at scale: one integration, one interface, and complete visibility across every account you manage.
3. Cross-channel analysis: combine Facebook Ads with Google Ads, GA4 & more
Facebook Ads rarely tells the full story on its own. Because Windsor connects hundreds of data sources, the same integration that brings Meta Ads into Claude can also pull in Google Ads, GA4, Shopify, CRM data, and more. You can analyze multi-channel performance with a single prompt.

About Windsor MCP: No-code Facebook Ads connector for Claude
Windsor MCP is the data integration layer between Meta Ads and Claude. This Facebook Ads connector for Claude automates the data prep you’d otherwise have to handle manually.
Instead of exporting, cleaning, and uploading reports yourself, Windsor MCP manages the entire pipeline so Claude always has access to fresh, structured, analysis-ready data.
Here is how it works:
- Pulls data directly from the Meta Ads API, so you’re working with live numbers, not yesterday’s snapshot.
- Normalizes and cleans the data in the background, removing inconsistencies and formatting issues that make raw ad data hard to work with.
- Streams the data into Claude, ready for analysis the moment you need it.
Think of it as the Facebook Ads LLM connector that bridges the gap between Meta’s API and Claude’s analytical power, making automatic Facebook Ads reporting in Claude a reality without writing code.
Key features of Windsor.ai’s Facebook Ads connector for Claude
Once you sync Facebook Ads with Claude through Windsor, you get:
- 710+ supported data fields covering every angle of campaign performance
- Data across account, campaign, ad set, ad, and creative levels
- Multi-account support, so agencies can connect multiple client ad accounts in one setup
And it doesn’t stop at Facebook Ads. Windsor connects 325+ data sources—GA4, Google Ads, Shopify, Instagram, HubSpot—all flowing into Claude through the same MCP connector. That means you can run cross-channel analysis without leaving Claude or stitching data together manually.
Alternative method: Manual CSV export from Facebook Ads to Claude
You can also bring Meta Ads data into Claude manually, but this approach comes with limitations.
How to connect Facebook Ads to Claude manually
This is often where marketers start when they want to analyze Facebook Ads metrics in Claude before they have an automated integration in place.
The typical integration steps include:
- Log in to Meta Ads Manager.
- Set your date range and select the metrics you want.
- Export the data as a CSV file.
- Upload the CSV directly into a Claude conversation.
- Ask Claude to analyze the file.
Why manual Facebook Ads to Claude integration falls short
Every marketer who has tried manual Facebook Ads Claude integration knows how quickly it breaks:
- Stale data: The moment you upload a CSV, the data starts aging. It no longer reflects what your campaigns are doing.
- Repetitive work: You repeat the entire export and upload process every time you need fresh insights.
- No scalability: Analyzing multiple accounts or clients means multiplying the workload.
- Cross-channel analysis is painful: You have to export and upload multiple CSVs separately to analyze performance across platforms.
- Slower decisions: You’re always one step behind the data that matters, which costs time and budget.
According to Meta’s own support documentation, CSV exports from Ads Manager come with additional problems: they fail with large date ranges (max 37 months), hang at 0% for high-volume reports, and strip out certain columns like tags, specific images, and audience breakdowns. Meta also limits exports to the first 10 languages for Advantage+ Creative ads.
Windsor MCP closes these gaps with a direct, API-level integration, so Claude always works with current Meta Ads data without manual intervention or maintenance.
⚙️ Windsor MCP closes these gaps with a direct, API-level integration, so Claude always works based on your current Meta Ads data without any manual intervention or maintenance from your side.
Conclusion
Manual exports create static snapshots that age out before your next meeting. Windsor MCP creates a live connection from Meta Ads to Claude that’s up and running in under a minute.
Once connected, the possibilities grow:
- Automate reporting without touching Ads Manager
- Analyze performance using plain language prompts
- Extract cross-channel insights across all your data sources
- Report on every client account you manage from a single interface
If you’re tired of exporting CSVs and ready to work with live data, this is how you connect Facebook Ads to Claude the right way.
🚀 See what your Facebook Ads data can tell you in Claude — try it free: https://onboard.windsor.ai/app/facebook.
FAQs
How can I send Facebook Ads data to Claude for analysis?
The most efficient way to send Facebook Ads data to Claude is through Windsor MCP, which connects directly to the Meta Ads API and streams live, structured data to Claude automatically. You can also export CSVs manually from Ads Manager and upload them into Claude, but that approach goes stale quickly and doesn’t scale.
Is there a tool to automate Facebook Ads reporting in Claude?
Yes. Windsor MCP is the top tool to connect Facebook Ads to Claude and enables fully automatic Facebook Ads reporting without manual exports, custom scripts, or repetitive work.
Can Claude analyze Facebook campaign performance if I connect my data?
Absolutely. Once connected, you can analyze Facebook Ads in Claude using plain language questions and get structured answers instantly. Windsor gives Claude access to campaign, ad set, ad, and creative level data, making it straightforward to analyze Meta Ads at any level of detail.
What’s the fastest way to integrate Facebook Ads into Claude?
Windsor MCP is the fastest option available. You can connect Facebook Ads to Claude in under a minute by adding the Windsor connector directly from Claude’s Connectors page, authorizing your Windsor account, and starting to query your data immediately.
Do I need coding skills to connect Facebook Ads to Claude with Windsor?
No. Windsor offers a fully no-code Facebook Ads to Claude integration through Claude’s native Connectors page. You simply search for Windsor.ai, authorize the connection, and that’s it. The Facebook Ads connector for Claude handles everything else under the hood.
Is Instagram Ads data included in the Facebook Ads connector?
Yes. Instagram Ads data is included automatically because both platforms are part of the Meta Ads ecosystem. You can analyze Facebook and Instagram campaign performance in a single dataset.
Does Windsor.ai include Facebook organic data in this connector?
No. This connector is designed for Facebook Ads only. Facebook Organic (Page Insights) is not included in the Ads connector, but can be accessed as a separate data source within Windsor.ai.
Does this setup work for multiple ad accounts or agencies managing multiple clients?
Yes. Windsor is built for scale, allowing you to connect Facebook Ads accounts to Claude for insights across as many clients as you manage. You can filter by account ID or account name directly inside your prompts, making marketing data to Claude automation seamless across an entire client portfolio.
What Facebook Ads metrics are available in Claude once I connect data via Windsor?
Windsor gives you access to 560+ metrics and 150+ dimensions, so you can sync Facebook Ads performance metrics to Claude at every level, from campaign down to individual creatives. This includes spend, ROAS, CPA, CTR, conversions, audience breakdowns, and much more.
Is Windsor MCP free? What plan do I need to use it with Claude?
Windsor MCP is available on all Windsor.ai plans, including the free 30-day trial.
How is using Windsor MCP different from uploading a CSV to Claude?
Uploading a CSV gives Claude a static snapshot that goes out of date immediately. Windsor MCP, on the other hand, creates a live Facebook Ads data pipeline to Claude that pulls fresh data directly from the Meta Ads API every time you ask a question. It is the difference between a one-time file, offering a fully automated way to automate ad data flows into Claude on demand.
Can I combine Facebook Ads data with other channels like Google Ads or GA4 inside Claude?
Yes. Windsor connects 325+ data sources, so the same integration that handles your ETL from Meta Ads to Claude also brings in Google Ads, GA4, Shopify, CRM platforms, and more. This makes true cross-channel analysis possible inside Claude and takes marketing data to Claude automation well beyond Facebook Ads alone.
Are there any rate limits for Meta Ads (Facebook Ads) data?
Yes — Meta Ads data is subject to Meta’s official API rate limits. These limits are defined by Meta and depend on factors such as the size of the account, query complexity, and data volume.
Windsor.ai does not impose additional artificial limits on top of the API, but very large or frequent requests may be throttled by Meta.
To ensure stable performance, data is automatically:
- batched and paginated
- cached where possible
- optimized for large queries
If you experience delays or partial data, it is usually due to Meta API throttling, and retrying after a short interval typically resolves it.
Windsor vs Coupler.io

