Deploy Meta ad campaigns directly from Claude.
meta-ads-manager-mcp is a free MCP server that connects Claude to the Meta Ads API. Describe the campaign you want in plain English. Claude creates the campaign, ad set, creatives, and ads. Every campaign starts paused so you review before a dollar gets spent.
Meta Ads Manager is a 47-tab interface.
Campaign creation, ad set targeting, creative upload, ad copy, billing, reporting. Each step lives in a different corner of Business Manager.
12+
steps to launch a single ad in Business Manager
4 tabs
minimum to create campaign, ad set, creative, and ad
1 prompt
to do all of it with meta-ads-manager-mcp
You describe it. Claude deploys it.
Add the server to your Claude config. Then manage campaigns in plain English. No API docs. No form fields. No tab switching.
Example prompt
"Create a Meta campaign targeting US fitness enthusiasts aged 25-40. Daily budget $30. Use the image at /Users/me/ads/hero.jpg. Copy: 'Track every rep. Hit every goal.' Headline: 'FitCommit AI'. CTA: Learn More. Link to fitcommit.ai."
Claude uploads the image, creates the campaign, builds the ad set with targeting, assembles the creative, and returns a campaign ID. Campaign starts paused.
5 tools included
create_meta_campaign
Full campaign setup: campaign, ad set, creatives, and ads in one call.
get_campaign_status
Check status of a campaign and all its ad sets and ads.
pause_campaign
Pause a live campaign immediately.
activate_campaign
Go live with a paused campaign.
delete_campaign
Permanently delete a campaign.
Built-in safeguards. No accidental spend.
Every campaign starts as PAUSED regardless of settings. dry_run mode simulates all API calls without making them. You review before anything goes live or spends money.
PAUSED by default
All campaigns create with status PAUSED. Nothing goes live until you explicitly call activate_campaign. Review the targeting, budget, and creative first.
dry_run mode
create_meta_campaign defaults to dry_run=True. Simulates every API call and returns mock IDs without touching your account or budget. Set to False when you are ready.
Two ways to get started.
Easiest: paste one prompt into Claude Code. It sets up everything automatically.
Option 1: Claude Code (easiest)
Paste this into Claude Code:
"Set up meta-ads-mcp for me: https://github.com/attainmentlabs/meta-ads-mcp"
Claude checks your environment, walks you through Meta credentials step by step, edits your ~/.mcp.json, and confirms when done.
Option 2: Manual via uvx
Add to ~/.mcp.json:
{
"mcpServers": {
"meta-ads": {
"command": "uvx",
"args": ["meta-ads-manager-mcp"],
"env": {
"META_ACCESS_TOKEN": "your-token",
"META_AD_ACCOUNT_ID": "your-account-id",
"META_PAGE_ID": "your-page-id"
}
}
}
}Need your Meta credentials? Read the setup guide
This is what we build for clients.
meta-ads-manager-mcp is the open source version. The client version is scoped to your workflows, integrated with your CRM, and deployed inside a broader AI automation system.
This tool
- Create, pause, activate, delete campaigns
- Claude handles Meta API calls
- dry_run mode for safe testing
- Open source, MIT licensed
- Manual credential setup required
Client deployment
- Full campaign automation tied to your product catalog or offers
- Connected to your CRM and customer data
- Automated performance reporting and budget pacing
- Creative generation from your brand guidelines
- Integrated with your existing marketing stack
Want this deployed for your business?
The free tool gets you started. The full version is scoped to your ad strategy, connected to your systems, and built by our team.