meta-ads-mcp
Manage Facebook ad campaigns directly from Claude Code. View performance metrics, adjust budgets, and control campaign status without opening Ads Manager.
Manage Instagram ad campaigns directly from Claude Code. View performance metrics, adjust budgets, and control campaign status without opening Ads Manager.
Manage Meta Ads (Facebook and Instagram) campaigns directly from Claude Code. View performance, adjust budgets, and control campaigns without opening Ads Manager.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@meta-ads-mcpShow me all active campaigns and how they're performing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Meta Ads MCP Server
Manage Facebook and Instagram ad campaigns directly from Claude Code. View performance, adjust budgets, and control campaigns without opening Ads Manager.
Tools
Tool | Description |
| List all campaigns with status and daily budget |
| Daily metrics: reach, impressions, clicks, spend, CPA, ROAS |
| List ad sets within a campaign |
| List ads within an ad set |
| Pause an active campaign |
| Reactivate a paused campaign |
| Change an ad set's daily budget |
| Overall account performance summary |
Related MCP server: ,
Setup
1. Install
pip install meta-ads-mcp2. Get Meta API Credentials
Create an app at Meta for Developers
Add the Marketing API product
Generate a long-lived access token with
ads_managementandads_readpermissions
3. Configure Environment
export META_APP_ID="your-app-id"
export META_APP_SECRET="your-app-secret"
export META_ACCESS_TOKEN="your-long-lived-token"
export META_AD_ACCOUNT_ID="1234567890"4. Add to Claude Code
Add to your ~/.claude/settings.json:
{
"mcpServers": {
"meta-ads": {
"command": "meta-ads-mcp",
"env": {
"META_APP_ID": "your-app-id",
"META_APP_SECRET": "your-app-secret",
"META_ACCESS_TOKEN": "your-token",
"META_AD_ACCOUNT_ID": "1234567890"
}
}
}
}Usage Examples
> Show me all active campaigns and how they're performing
> Which ad set is spending the most with the worst results?
> Pause campaign 12345, it's burning budget
> Give me a summary of last 7 days across the whole accountPricing
Free: Read-only access (view campaigns, metrics, insights)
Pro ($15/mo): Full read/write (pause, enable, adjust budgets)
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Create, launch, and manage Meta + Google ads from Claude and ChatGPT.
Run Google, Meta, Microsoft, TikTok and LinkedIn Ads from Claude or ChatGPT. Writes need approval.
Run Google Ads and Meta Ads from ChatGPT or Claude: audit wasted spend, create and manage campaigns.
Ask Claude about your ads: Meta, Google, TikTok, LinkedIn, GA4 & Shopify. No AI credits.
Related MCP Servers
- AlicenseBqualityBmaintenanceSupervised Meta Ads operating system for Claude Code. 57 tools for campaign management, multi-asset ads, targeting, pixel diagnostics, catalogs, and safety gates. All ads created PAUSED - operator approves every action.5744MIT
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to manage Facebook and Instagram advertising campaigns through the Meta Marketing API. Supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.-
- AlicenseNot gradedqualityDmaintenanceEnables users to create, manage, and monitor Meta (Facebook/Instagram) ad campaigns directly from Claude using natural language.33 PyPI14MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude to fetch and analyze Meta ad accounts, campaigns, ad sets, ads, and performance insights via the Meta Marketing API.1,040 npmMIT