Meta MCP for Claude: how to connect
Claude to Meta Ads

How to connect Claude to Meta Ads via MCP

Four steps, using Meta’s official MCP server. The whole thing takes about 10 minutes the first time, and the only fiddly part is editing one config file. Each step states what you do and what you should see when it worked.

1. Authenticate with Meta Business OAuth to grant Claude access. Open Meta’s AI connectors page and click “Connect to AI tool.” Approve the requested ad-account scopes on the standard Meta Business OAuth screen — the same login Shopify and Mailchimp use — then copy the MCP URL Meta provisions for your Business account.
2. Add the MCP URL to Claude Desktop so Claude can reach your account. In Claude Desktop, go to Settings → Developer → Edit Config. That opens claude_desktop_config.json. Paste the mcpServers block below (swap in your business ID) and save the file.
3. Quit and reopen Claude to load the connection. Fully quit Claude with Cmd-Q — closing the window is not enough — then reopen it. Wait a few seconds for the green “connected” indicator to appear next to the Meta MCP server. If it stays red, your JSON has a syntax error (a trailing comma is the usual culprit).
4. Run your first prompt to confirm read access works. Ask Claude, in plain English, “show my top 10 ad sets by spend last 7 days.” A Markdown table comes back, which tells you the connection is live and you can start querying campaigns.

Prefer to skip the config edit? Ryze AI’s one-click connector wires the same access through a single OAuth click with no JSON to touch — the full walkthrough is lower down. For the deep developer-side configuration of Meta’s own server, see the official Meta MCP server setup and configuration guide.

Proof it works — the Meta MCP connected to Claude Desktop, with a creative-fatigue audit returning a Markdown table.

What you can do once Claude is connected to Meta Ads

With the Meta MCP live, you type questions and instructions in plain English and Claude works against your real account. A few examples to start with:

• ✓“Show me my top 10 ad sets by spend last 7 days, with frequency and ROAS.”
• ✓“Pause every ad set with frequency over 4 and CPM trending up.”
• ✓“Bump my best-performing campaign’s budget by 20% but cap at $500/day.”
• ✓“Audit my product catalog — flag SKUs with broken images or missing GTINs.”

Two ways to connect Meta MCP to Claude, side-by-side. Manual setup is six steps and around 30 minutes — install the local bridge, copy your API key, edit Claude Desktop’s config, restart. Ryze AI’s hosted connector is three clicks and around one minute, no config edit required.

What the Meta MCP actually does

The MCP exposes your live Meta Ads account to Claude: campaign listing, ad-set inspection, budget updates, catalog management, and signal diagnostics. So the prompts above aren’t read-only reports — Claude can propose and apply real changes once you approve them.

It all runs through Meta’s standard Business OAuth — the same one Shopify and Mailchimp use. The practical upside for marketers: no Meta Developer App, no Marketing API approval wait. You can be querying live campaigns within minutes instead of the old 1-3 day wait.

Meta offers two flavors of this same capability:

• →Meta Ads MCP server — HTTP-based, paste a URL into Claude Desktop or ChatGPT. This is the one most marketers want.
• →Meta CLI — local terminal binary for Claude Code or Codex. This is for developers. If you’ve never opened a terminal, skip it.

One quieter benefit worth noting: because this is Meta’s officially supported automation path, the long-running worry that “using AI to manage Meta Ads gets your account banned” no longer applies. For how the official server stacks up against the wider field of third-party options, see Best MCP for Meta Ads in 2026. If you also run Google Ads, the same plain-English approach is covered in connect Claude to Google Ads, step by step, and a dozen ready-made plays live in 9 Claude workflows for Google and Meta Ads.

MCP or CLI — which one is for you?

Same Meta Marketing API underneath. Different way of getting at it. The 10-second answer: if you use Claude Desktop or ChatGPT, you want the MCP. If you live in a terminal with Claude Code, you want the CLI. Most marketers want the MCP. Here’s the side-by-side.

Screenshot — the Meta Ads CLI running in a terminal session, ready for Claude Code / Codex.

The official MCP install, and where it bites

The four steps at the top of this page are the whole procedure. This section is the honest detail on the one step that actually costs time — editing the config — plus what to do when the connection fails. Meta’s own setup docs are at facebook.com/business/help/1456422242197840, and the full developer-side configuration of the server is in the Meta MCP server setup and configuration guide.

• →Finding the config file eats most of the 10 minutes. Settings → Developer → Edit Config opens claude_desktop_config.json in your default editor — that step trips people up more than the JSON itself.
• →A red indicator almost always means a JSON syntax error. A trailing comma or a missing brace in the mcpServers block is the usual cause. Paste the config into any JSON validator before restarting.
• →Closing the window is not quitting. The new server only loads on a full Cmd-Q and reopen, so a connection that never appears is often just a window that was never actually quit.
• →If your first prompt errors, it is read access, not the prompt. Re-approve the ad-account scopes in the OAuth step and confirm the MCP URL in your config matches the one Meta provisioned.

None of this applies to the one-click path — Ryze AI’s hosted connector skips the config edit, so there is no JSON to get wrong. The full walkthrough is below.

Side-by-side: which path wins on which thing

Six things that actually matter when you’re running real ad budgets. Setup time, whether you have to touch a CLI or config file, multi-account handling for agencies, and what you get done while you sleep. The orange row is the marketer/agency pick.

Comparison reflects Meta’s official MCP and CLI in open beta, current as of June 2026. Setup times are wall-clock estimates from a fresh laptop — including hunting for Claude Desktop’s config path on first install.

Which one is for you?

Two clean personas cover ~95% of readers. If you’re in a third bucket (scientist, hobbyist, edge case), the side-by-side above has what you need.

The 2-minute path: Ryze AI’s one-click Meta connector

Three steps. Each one has a concrete outcome so you can tell when it worked. Genuinely one click on the OAuth screen. No Meta CLI install. No JSON config to edit beyond pasting one URL into Claude Desktop.

Screenshot — Ryze AI’s one-click Meta connector running creative-fatigue audit + agent pause inside Claude.