Skip to content
MCP server

Ads MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.1
Listing updated
5 days ago

About Ads MCP

Ads MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GOOGLE_ADS_CLIENT_IDOAuth client ID from Google Cloud ConsoleRequired
  • GOOGLE_ADS_CLIENT_SECRETOAuth client secret from Google Cloud ConsoleRequired
  • GOOGLE_ADS_DEVELOPER_TOKENDeveloper token from Google Ads API CenterRequired
  • GOOGLE_ADS_REFRESH_TOKENRefresh token minted via `pnpm google:auth`Required
  • GOOGLE_ADS_CUSTOMER_IDDefault Google Ads account ID, 10 digits, no dashesRequired
  • GOOGLE_ADS_LOGIN_CUSTOMER_IDMCC account ID, only if the customer account is managed under one
  • META_APP_IDMeta App ID from developers.facebook.comRequired
  • META_APP_SECRETMeta App secretRequired
  • META_ACCESS_TOKENLong-lived System User access token with ads_management scopeRequired
  • META_AD_ACCOUNT_IDDefault Meta ad account ID, numeric, no act_ prefixRequired

Pricing

Open source

Ads MCP 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.

How AIPoweredBot checks servers

Alternatives to Ads MCP

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.2K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. Self-hostable MCP server for managing Snapchat Ads campaigns, reports and audiences from

    Not checked yet
    • Remote
    • Open source
    • 8 GitHub stars
    • Marketing and SEO
  4. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  5. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  6. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO