MCP server for creating and managing Meta (Facebook/Instagram) ad campaigns directly from Claude. Tell Claude what you want. It deploys.
Built by Attainment Labs.
Add this server to your Claude config. You get 5 tools:
| Tool | What it does |
|---|---|
create_meta_campaign | Create a full campaign: campaign, ad set, creatives, and ads |
get_campaign_status | Check status of a campaign, its ad sets, and ads |
pause_campaign | Pause a live campaign |
activate_campaign | Activate a paused campaign |
delete_campaign | Permanently delete a campaign |
All campaigns are created as PAUSED by default. You review before spending.
If you use Claude Code, paste this prompt:
"Set up meta-ads-mcp for me: https://github.com/attainmentlabs/meta-ads-mcp"
Claude will check your environment, walk you through getting your Meta credentials step by step, edit your ~/.mcp.json, and confirm when it's done. No docs to read.
# No setup required — uvx runs it directlyAdd to ~/.mcp.json:
{ "mcpServers": { "meta-ads": { "command": "uvx", "args": ["meta-ads-manager-mcp"], "env": { "META_ACCESS_TOKEN": "your-token-here", "META_AD_ACCOUNT_ID": "your-account-id", "META_PAGE_ID": "your-page-id" } } } }pip install meta-ads-manager-mcpThen in ~/.mcp.json:
{ "mcpServers": { "meta-ads": { "command": "meta-ads-manager-mcp", "env": { "META_ACCESS_TOKEN": "your-token-here", "META_AD_ACCOUNT_ID": "your-account-id", "META_PAGE_ID": "your-page-id" } } } }You need three values from Meta. Full step-by-step walkthrough: SETUP.md
| Variable | Where to find it |
|---|---|
META_ACCESS_TOKEN | Graph API Explorer — long-lived token with ads_management permission |
META_AD_ACCOUNT_ID | Business Manager: Ad Accounts — numbers only, no act_ prefix |
META_PAGE_ID | Facebook Page: About → Page transparency → Page ID |
The access token expires after 60 days. See SETUP.md for the exchange flow.
Once the server is connected, just describe what you want:
Create a campaign:
"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."
Check status:
"What's the status of campaign 120243616427570285?"
Pause:
"Pause campaign 120243616427570285."
Activate:
"Go live with campaign 120243616427570285."
Delete:
"Delete campaign 120243616427570285."
create_meta_campaign defaults to dry_run=True. This simulates all API calls and returns fake IDs without making any requests or spending money. Set dry_run=False when you're ready to deploy.
Prefer writing campaigns as config files? Use meta-ads-cli — the companion CLI tool.
- Python 3.9+
uvfor the uvx install path- A Meta Business Manager account with an ad account and Facebook Page
MIT
