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_campaigns	List all campaigns with status and daily budget
get_campaign_insights	Daily metrics: reach, impressions, clicks, spend, CPA, ROAS
list_adsets	List ad sets within a campaign
list_ads	List ads within an ad set
pause_campaign	Pause an active campaign
enable_campaign	Reactivate a paused campaign
update_adset_budget	Change an ad set's daily budget
get_account_summary	Overall account performance summary

Setup

1. Install

pip install meta-ads-mcp

2. Get Meta API Credentials

1. Create an app at Meta for Developers
2. Add the Marketing API product
3. Generate a long-lived access token with ads_management and ads_read permissions

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 account

Pricing

• Free: Read-only access (view campaigns, metrics, insights)
• Pro ($15/mo): Full read/write (pause, enable, adjust budgets)

License

MIT