Meta Ads MCP Server

by mikusnuzio.github.mikusnuz/meta-adsv1.5.0

Meta Marketing API: manage Facebook and Instagram ad campaigns, audiences, creatives, insights, catalogs and automated rules.

83Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Meta Ads MCP server

claude mcp add meta-ads-mikusnuz -e META_ADS_ACCESS_TOKEN='<meta-ads-access-token>' -e META_APP_SECRET='<meta-app-secret>' -- npx -y @mikusnuz/meta-ads-mcp

{
  "mcpServers": {
    "meta-ads-mikusnuz": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "env": {
        "META_ADS_ACCESS_TOKEN": "<meta-ads-access-token>",
        "META_APP_SECRET": "<meta-app-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "meta-ads-mikusnuz": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "env": {
        "META_ADS_ACCESS_TOKEN": "<meta-ads-access-token>",
        "META_APP_SECRET": "<meta-app-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "meta-ads-mikusnuz": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "env": {
        "META_ADS_ACCESS_TOKEN": "<meta-ads-access-token>",
        "META_APP_SECRET": "<meta-app-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "meta-ads-mikusnuz": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "env": {
        "META_ADS_ACCESS_TOKEN": "<meta-ads-access-token>",
        "META_APP_SECRET": "<meta-app-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
META_ADS_ACCESS_TOKEN	yes	yes	Meta Marketing API access token
META_AD_ACCOUNT_ID	—	—	Meta Ad Account ID (e.g. act_123456)
META_APP_ID	—	—	Meta App ID
META_APP_SECRET	—	yes	Meta App Secret
META_BUSINESS_ID	—	—	Meta Business Manager ID
META_PIXEL_ID	—	—	Meta Pixel ID

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-04-12 · 6mo ago · GitHub · v1.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-08 · 1d ago · official registry · v1.5.0

FAQ

›How do I install the Meta Ads MCP server in Claude Code?

Run: claude mcp add meta-ads-mikusnuz -e META_ADS_ACCESS_TOKEN='<meta-ads-access-token>' -e META_APP_SECRET='<meta-app-secret>' -- npx -y @mikusnuz/meta-ads-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Meta Ads require an API key?

Yes. It expects META_ADS_ACCESS_TOKEN, META_APP_SECRET, of which 2 are secrets.

›Can I use Meta Ads as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Meta Ads in the official MCP registry?

Yes, as io.github.mikusnuz/meta-ads.