← Back to Resource Bank
Get Clients · Meta Ads

Connect Meta Ads to Claude

Pull reports and manage campaigns from Claude instead of clicking around in Ads Manager. Two setup routes, both official.

Meta has an official way to connect your ad account to AI tools like Claude, called Ads AI Connectors. Once connected, you can pull performance data, manage campaigns, adjust budgets, and work with catalogs without manually clicking through Ads Manager.

There are two ways to set it up. MCP is the more direct, tool-based route. CLI gives you more control and is easier to audit. Pick based on how hands-on you want to be.

What This Can Do
Pull ad performance reports and insights
Create and manage campaigns, ad sets, and ads
Update budgets and other campaign settings
Manage catalogs and other Meta ad assets
What You Need First
A Meta Business Manager account with access to the ad account you want to use.
A Meta developer app (usually a Business app), if you're setting up API access manually.
A system user in Business Manager for secure access token generation.
Access to Claude or Claude Code, depending on which route you choose.
Route 1: MCP
Best for a fully AI-driven workflow

Use MCP if you want the cleanest AI experience. Claude sends structured requests to a Meta Ads tool layer, and that layer handles the actual API work. This is the best option if you want the least amount of manual terminal work once the connector is set up.

Meta's Ads AI Connectors use Meta-authenticated access. The connector talks to Meta's Ads MCP server behind the scenes, and Claude queries or acts on your ad account through that connection.

1

Confirm your Business setup. Make sure the ad account is inside a Business Manager you control.

2

Create a system user. Business Settings → Users → System Users → create a new system user for this integration.

3

Assign assets. Give that system user access to the ad account you want Claude to use.

4

Generate a token. Generate a system user access token and select the permissions needed for ads access.

5

Connect your AI tool. Use the token to authenticate the Meta Ads connector inside your AI setup.

6

Test it read-only. Start with prompts like the ones below before you let Claude write anything.

"Show me performance for the last 7 days."
"List active campaigns."
"Break down spend by campaign."
Route 2: CLI
Best for power users and operators

Use CLI if you want more control, easier debugging, or a setup that works well with Claude Code in your terminal. It's also the better route if you want to inspect commands before anything applies to a live account.

You install Meta's official Ads CLI, authenticate it with a system user access token, and Claude helps you write or run commands from the terminal.

1

Set up Business access. Make sure your ad account is available in Business Manager with admin or sufficient access.

2

Create a system user. Business Settings → Users → System Users → create a dedicated system user for the CLI.

3

Assign the ad account. Give that system user access to the specific account you want to manage.

4

Generate your token. Create a system user access token with the correct ad permissions.

5

Install the Ads CLI. Follow Meta's official setup docs and install it on your machine.

6

Authenticate. Add the token to the CLI using the method in Meta's setup guide.

7

Run a test command. Try "list ad accounts," "list campaigns," or "fetch insights for the last 7 days."

8

Use Claude as your operator. Once the CLI works, ask Claude to draft the commands.

"Pull a performance summary for all active campaigns."
"Generate a budget shift plan based on last 7 days of results."
"Draft the commands to pause low-performing ad sets."
MCP vs CLI
OptionBest forProsCons
MCPFully AI-driven workflowMost natural Claude experience, least manual workMore abstract, harder to debug
CLIPower users and operatorsClear control, easy to audit, easier to troubleshootMore terminal work
Token Setup

This is the part most people get stuck on. Meta's docs point you toward a system user access token, the right choice for automation and server-to-server use. It's easier to scope, revoke, and keep separate from your everyday Meta login.

Assign only the ad account you need.
Give only the permissions required for what you want Claude to do.
Store the token securely. Never paste it into a public place.

For anything that can spend money, use this flow, especially for budget changes, campaign launches, and pauses:

1
Claude suggests the action
2
You review the change
3
You approve the command or API action
4
The tool applies it
Common Issues
"I can't see my ad account"
Usually means the system user isn't assigned to the ad account correctly. Recheck Business Settings → Users → System Users.
"Token doesn't work"
Usually means the token was generated for the wrong app, the wrong user, or the wrong permissions. Regenerate it and double-check the scope.
"Claude can read but not write"
You likely have read-only permissions instead of management permissions on the token.
"Setup looks different from the guide"
Meta changes the UI often, but the core structure stays the same: Business Manager, system user, token, permissions, then connector or CLI.