# Ads MCP

> Ads MCP is an open-source MCP server for marketing and seo. MCP server for Google Ads and Meta Ads. Wraps both APIs directly to manage campaigns. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/gudlab/ads-mcp
- **MCP Registry name:** io.github.gudlab/ads-mcp
- **Categories:** marketing and SEO
- **Listing updated:** 2026-11-13

## About

MCP server for Google Ads and Meta Ads. Wraps both APIs directly to manage campaigns.

## Install

### Claude Code (Terminal)

```sh
claude mcp add ads-mcp --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' --env GOOGLE_ADS_CUSTOMER_ID='<GOOGLE_ADS_CUSTOMER_ID>' --env META_APP_ID='<META_APP_ID>' --env META_APP_SECRET='<META_APP_SECRET>' --env META_ACCESS_TOKEN='<META_ACCESS_TOKEN>' --env META_AD_ACCOUNT_ID='<META_AD_ACCOUNT_ID>' -- npx -y @gudlab/ads-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
        "META_APP_ID": "<META_APP_ID>",
        "META_APP_SECRET": "<META_APP_SECRET>",
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
        "META_APP_ID": "<META_APP_ID>",
        "META_APP_SECRET": "<META_APP_SECRET>",
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ads-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
        "META_APP_ID": "<META_APP_ID>",
        "META_APP_SECRET": "<META_APP_SECRET>",
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
        "META_APP_ID": "<META_APP_ID>",
        "META_APP_SECRET": "<META_APP_SECRET>",
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
        "META_APP_ID": "<META_APP_ID>",
        "META_APP_SECRET": "<META_APP_SECRET>",
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
      }
    }
  }
}
```

## FAQ

### Is Ads MCP free?

Yes. Ads MCP is open source, so you can use and self-host it for free.

### How do I add Ads MCP to Claude Code?

Run this command in your terminal: claude mcp add ads-mcp --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' --env GOOGLE_ADS_CUSTOMER_ID='<GOOGLE_ADS_CUSTOMER_ID>' --env META_APP_ID='<META_APP_ID>' --env META_APP_SECRET='<META_APP_SECRET>' --env META_ACCESS_TOKEN='<META_ACCESS_TOKEN>' --env META_AD_ACCOUNT_ID='<META_AD_ACCOUNT_ID>' -- npx -y @gudlab/ads-mcp

### What are the best alternatives to Ads MCP?

The closest alternatives to Ads MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Snapchat Ads MCP Server, MCP and Red Center Studio free tools.

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Snapchat Ads MCP Server](https://ai-powered.com/mcp/snapchat-ads-mcp-server): Snapchat Ads MCP Server is an open-source MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/ads-mcp-2
