meta-ads-mcp-server

# meta-ads-mcp-server > MCP server for the Meta Marketing API (Facebook & Instagram Ads) — 300+ tools. [](https://pypi.org/project/meta-ads-mcp-server/) [](https://pypi.org/project/meta-ads-mcp-server/) [](https://github.com/mattyu-dev/mcp-meta/blob/main/LICENSE) ## Install ### Option 1: uvx (zero install, recommended) Add this to your MCP client config (e.g. Claude Desktop's `claude_desktop_config.json`): ```json { "mcpServers": { "meta-ads": { "command": "uvx", "args": ["meta-ads-mcp-server"], "env": { "META_ACCESS_TOKEN": "YOUR_TOKEN", "META_DEFAULT_AD_ACCOUNT_ID": "act_YOUR_ACCOUNT_ID" } } } } ``` ### Option 2: pip install ```bash pip install meta-ads-mcp-server ``` Then add to your MCP client config: ```json { "mcpServers": { "meta-ads": { "command": "meta-ads-mcp", "env": { "META_ACCESS_TOKEN": "YOUR_TOKEN", "META_DEFAULT_AD_ACCOUNT_ID": "act_YOUR_ACCOUNT_ID" } } } } ``` ### Option 3: Interactive Setup Wizard ```bash pip install meta-ads-mcp-server meta-ads-setup ``` The wizard auto-detects your installed MCP clients (Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI) and configures them for you. ## Getting Your Meta Access Token 1. Go to [Meta Business Settings > System Users](https://business.facebook.com/settings/system-users) 2. Create or select a System User 3. Click **Generate New Token** 4. Select `ads_management` and `ads_read` permissions 5. Copy the token ## Licensing **Free tier** (no key needed): 10 read-only tools — insights, campaign search, spend trends, business listing, and more. Enough to explore and evaluate. **Pro tier** (license key): Unlocks all 300+ tools including campaign creation, audience management, optimization, fraud detection, and th…