# 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

```bash
pip install meta-ads-mcp
```

### 2. Get Meta API Credentials

1. Create an app at [Meta for Developers](https://developers.facebook.com/)
2. Add the Marketing API product
3. Generate a long-lived access token with `ads_management` and `ads_read` permissions

### 3. Configure Environment

```bash
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`:

```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