VidAU Editorial · AI Search
How to Install and Use the Official meta ads mcp with Claude (Step‑by‑Step Guide)
Learn how to safely install and use the official Meta Ads MCP in Claude. Connect your ad account, pull reports, analyze winners, adjust budgets, and avoid common rollout pitfalls plus when to use cross-channel MCP alternatives.
By the VidAU Editorial Team · Reviewed before publishing
The official Meta Ads MCP is live here’s the safe, step-by-step way to connect it to Claude, verify access, and run your first ROAS and creative‑winner checks. We’ll also flag the current rollout limits so you don’t hit a permissions wall mid‑setup.
If you run Facebook Ads or Instagram Ads, the new official Meta Ads MCP lets Claude securely read and manage your ad account without risky unofficial connectors. Use this guide to install it, confirm access, run first reports, and safely approve changes.
Quick Summary
• Claude with the official Meta Ads MCP is the safest way to pull reports, audit performance, and take controlled actions in 2026.
• Porter Metrics MCP or Markifact MCP are strong alternatives for cross-channel reporting and multi-platform workflows when you need more than Meta.
• Business Manager admin, correct asset permissions, and 2FA are required; rollout and write access vary by account and region.
• US media buyers, performance marketers, and agencies get the fastest wins: instant ROAS checks, creative-winner analysis, and safe budget moves.
What Is Meta Ads MCP?
Meta Ads MCP is Meta’s official Model Context Protocol server that connects MCP‑compatible AI clients like Claude to your Meta ad accounts. It enables secure, permissioned access for reading performance data and, where enabled, performing campaign, ad set, and ad actions. It replaces unofficial connectors that risked policy violations and account restrictions.
Prerequisites: Pass This Access & Settings Check
Before installing, confirm these fundamentals to prevent connection failures:
• Business Manager: You are an admin for the Business Manager that owns the ad account.
• Ad Account Access: You have at least Advertiser access; Editor/Admin for write actions.
• Two‑Factor Authentication: 2FA is enabled on your Meta account.
• Pixel & Catalog: Your Pixel and Catalog (if used) are correctly assigned to the Business Manager and linked to the target ad account.
• Instagram Account: Connected to the Business Manager and ad account if you run IG placements.
• Naming & Hygiene: Consistent campaign/ad set/ad naming and UTMs help Claude interpret results reliably.
Suggested Visual: A simple diagram showing Business Manager → Assets (Ad Accounts, Pixel, Catalog, IG) → Claude via Meta Ads MCP.
Install meta ads mcp in Claude (Step‑by‑Step)
Follow these steps in Claude Desktop (or your MCP‑compatible Claude client):
1) Open Claude Desktop and go to the MCP connections or Tools section.
2) Add a new MCP server and paste the official Meta Ads MCP server address from Meta’s documentation.
3) Authenticate via Meta’s OAuth flow. Choose the Business Manager, Pages, and Ad Accounts you want Claude to access.
4) Grant requested scopes. If you are unsure, start read‑only and expand later.
5) Finish setup and return to Claude; confirm the Meta Ads MCP tools are listed.
6) Test access with a prompt like:
• “Connect to my primary ad account and show ROAS, CPA, CTR, and CPM by campaign for the last 7 days.”
7) If you manage multiple ad accounts, specify the ID or name in your prompt.
If you do not see the tools or get permission errors, jump to the Rollout & Troubleshooting section.
Suggested Visual: Claude settings screen with an arrow to the “Add MCP server” step and an OAuth confirmation panel.
First‑Use Workflows: Reporting, Audits, and Creative Checks
Start with fast, trustworthy reads before making any changes.
Copy‑paste prompts:
• ROAS Rollup (last 7 days):
• “For ad account [ID or name], list Campaign → Spend, Impressions, CTR, CPM, Purchases, ROAS for the last 7 days. Flag any campaign with ROAS below breakeven [X].”
• Creative Winners (by ad):
• “Analyze active ads by Post ID or Ad ID for the last 14 days. Report CTR, CPC, Landing‑page CVR (if available), Purchases, ROAS. Identify top 3 winners and 3 losers and explain the performance gap.”
• Account Hygiene:
• “Find ad sets stuck in Learning Limited, high frequency (>3 last 7 days), or overlapping audiences. Recommend consolidations or pauses with expected impact.”
• Scaling Candidates:
• “Identify scalable campaigns (stable CPA ±10% over 10 days, frequency <2.5, positive ROAS trend). Propose +20% budget steps and guardrails.”
• Platform Breakdown:
• “Break down performance by placement (Feed, Reels, Stories, Audience Network). Flag any placement inflating CTR but not contributing conversions.”
Suggested Visual: A sample Claude response summarizing campaigns with green/yellow/red performance badges.
Key Takeaways
• Start read‑only to validate data and naming hygiene.
• Always specify account and time window for reproducible results.
• Compare winners at the ad level to find true message‑to‑page match.
Safely Making Changes via Claude + Pre‑Launch QA Checklist
When write actions are enabled for your account, keep human‑in‑the‑loop controls. Example workflow:
1) Ask for a draft plan:
• “Propose budget changes for under‑performing ad sets (CPA > target by 20%) and for top performers (stable CPA, rising ROAS). Do not execute yet.”
2) Review the proposed changes line‑by‑line.
3) Approve selectively with an explicit command:
• “Apply only the approved changes listed in my summary. Confirm what was changed and when.”
Pre‑Launch / Change QA Checklist:
• Objective matches goal (Sales/Leads/Traffic as intended).
• Pixel event and Aggregated Event Measurement are correct.
• Geo, age, language, and placements are accurate.
• Exclusions: existing buyers, overlapping audiences.
• Daily/total budget and schedule windows are correct.
• Creative: correct Post IDs or ad variants, final copy, brand safety.
• UTMs present and consistent with analytics conventions.
• Naming: campaign/ad set/ad names follow your standard.
• Account spend limit and billing status OK.
• Final summary reviewed; screenshot or export kept for audit.
Rollout Notes, Limits, and Troubleshooting
Current reality, based on the official rollout:
• Staged Enablement: Not all accounts/regions are live. Some users see read‑only access first.
• Varying Tools: Creative uploads or some write actions may be restricted.
• Permissions Matter: Missing Business Manager admin or asset assignments cause silent failures.
• Prompt Specificity: Include account ID/name and date ranges to avoid empty responses.
If the tools do not appear in Claude or actions fail:
• Re‑run OAuth and explicitly select the correct Business Manager and ad accounts.
• Verify 2FA and Business Manager admin status.
• Confirm Pixel, Catalog, Pages, and Instagram account are assigned to the same Business Manager.
• Try another MCP client like ChatGPT or Perplexity to verify whether it is a client‑specific issue.
• Fall back to read‑only analysis until write scopes appear for your account.
When to Use Alternatives: Cross‑Channel or Expanded Workflows
Use the official Meta Ads MCP for deep, single‑platform work. If you need blended reporting or multi‑platform automations, consider these options:
• Use Case: Meta‑only reporting/ops
Recommended Tools: Meta Ads MCP in Claude
Why: Native, safest path in 2026
• Use Case: Cross‑channel reporting
Recommended Tools: Porter Metrics MCP
Why: One MCP for 20+ platforms
• Use Case: Multi‑platform ops & agents
Recommended Tools: Markifact MCP
Why: Unified workflows beyond Meta
• Use Case: Quick browser checks
Recommended Tools: Perplexity + Meta Ads MCP
Why: Fast questions, light analysis
• Use Case: Prompts in ChatGPT
Recommended Tools: Meta Ads MCP in ChatGPT
Why: Good if your team lives in ChatGPT
• Use Case: Creative ideation
Recommended Tools: Higgsfield (MCP or app)
Why: Generate new concepts rapidly
Note: Capabilities and write scopes vary by account and client. Always verify available tools in your environment.
Create With VidAU
Turn scripts, product URLs, and creative ideas into ad-ready video assets with a structured AI workflow.
Key takeaway
Final Thoughts
The official Meta Ads MCP gives US media buyers a safer, faster way to audit accounts, confirm winners, and make controlled changes from a chat interface. Start with read‑only prompts, validate access and naming hygiene, and use the QA checklist before approving any edits.
If your audit shows you need fresh video variants, you can produce testable short‑form ads fast with VidAU AI Video. Input a product URL or images, generate Meta‑ready video creative in multiple styles, then launch and measure through the Meta Ads MCP to close the loop.
Frequently asked questions
What is the Meta Ads MCP and why is it safer?
The Meta Ads MCP is Meta’s official Model Context Protocol server that securely connects AI clients like Claude to your ad account. It uses Meta’s authenticated permissions instead of unofficial workarounds, reducing the risk of policy violations or account restrictions while enabling read and, where allowed, write actions.
How do I install the Meta Ads MCP in Claude?
Open Claude Desktop, add a new MCP server, and paste the official Meta Ads MCP address from Meta’s documentation. Authenticate via Meta’s OAuth, choose your Business Manager and ad accounts, grant scopes, and test with a prompt to pull last 7‑day ROAS and CPA by campaign. Access varies by rollout and permissions.
I do not see write actions. Is something wrong?
Not necessarily. The rollout is staged, and some accounts have read‑only tools initially. You also need the correct Business Manager role and ad account permissions. Re‑check OAuth scopes, confirm admin status, and verify assets like Pixel and Catalog are assigned to the same Business Manager.
Can I use the Meta Ads MCP with ChatGPT or Perplexity?
Yes. The Meta Ads MCP works with MCP‑compatible clients, including Claude, ChatGPT, and Perplexity. Exact capabilities can vary by client and plan, so install the connector, authenticate, and list available tools in each client to see what is enabled for your account.
What first prompts should I run after setup?
Start with reporting and diagnostics: last 7‑day ROAS/CPA by campaign, creative winners by Ad ID, learning‑limited and high‑frequency ad sets, placement breakdowns, and a scaling proposal. Keep prompts specific to account, time window, and targets to ensure consistent, actionable responses.
What permissions do I need in Business Manager?
Admin for the Business Manager is strongly recommended, plus Advertiser or Editor/Admin on the ad account for write actions. Ensure 2FA is enabled, and that Pixel, Catalog, Pages, and Instagram accounts are correctly assigned to the same Business Manager and linked to the target ad account.
Can the Meta Ads MCP launch campaigns and adjust budgets?
In many accounts, yes—once write scopes are enabled. Always request a draft plan first, review line‑by‑line, and then approve selected changes explicitly. Use a QA checklist to confirm objectives, targeting, budgets, creative IDs, and UTMs before execution to prevent unintended edits.
Why are my ROAS or conversion metrics missing?
Common causes include incorrect attribution settings, Pixel not assigned to the ad account, events misconfigured, or the time window being too short. First validate attribution and Pixel events, then re‑run the prompt with a longer date range and explicit account ID or name to ensure the correct data source.
When should I use Porter Metrics MCP or Markifact MCP instead?
Choose Porter Metrics MCP for cross‑channel dashboards and blended KPIs across Meta, Google Ads, GA4, TikTok Ads, and more. Use Markifact MCP when you need multi‑platform operations with AI agents and workflows. For deep, single‑platform Meta work, the official Meta Ads MCP in Claude remains the first choice.
Does it support the Meta Ad Library for competitor research?
Clients can often ask the MCP to reference the Meta Ad Library for examples, but availability varies. If supported in your setup, prompt Claude to identify competitor hooks, offers, and formats, then compare those ideas to your top‑performing creatives before testing any new variations.
