io.github.gudlab/ads-mcp

io.github.gudlab/ads-mcp

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

View repository →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gudlab/ads-mcp@0.1.1"
      ],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "<your GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<your GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<your GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<your GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<your GOOGLE_ADS_CUSTOMER_ID>",
        "META_APP_ID": "<your META_APP_ID>",
        "META_APP_SECRET": "<your META_APP_SECRET>",
        "META_ACCESS_TOKEN": "<your META_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<your META_AD_ACCOUNT_ID>"
      }
    }
  }
}
Environment variables
  • GOOGLE_ADS_CLIENT_IDrequiredsecretOAuth client ID from Google Cloud Console
  • GOOGLE_ADS_CLIENT_SECRETrequiredsecretOAuth client secret from Google Cloud Console
  • GOOGLE_ADS_DEVELOPER_TOKENrequiredsecretDeveloper token from Google Ads API Center
  • GOOGLE_ADS_REFRESH_TOKENrequiredsecretRefresh token minted via `pnpm google:auth`
  • GOOGLE_ADS_CUSTOMER_IDrequiredDefault Google Ads account ID, 10 digits, no dashes
  • META_APP_IDrequiredMeta App ID from developers.facebook.com
  • META_APP_SECRETrequiredsecretMeta App secret
  • META_ACCESS_TOKENrequiredsecretLong-lived System User access token with ads_management scope
  • META_AD_ACCOUNT_IDrequiredDefault Meta ad account ID, numeric, no act_ prefix

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.1.1
Registry
active
Published
9/22/2026

More Developer Tools servers

Browse all Developer Tools →

io.github.gudlab/gud-api-mcp

gudlab

AI agents create, run, and save API requests as Gud API collections in your project.

Developer ToolsAdded 4 months ago

Relay

gudsol

Shared, private memory for ChatGPT, Claude, Cursor and 20+ AI tools. Plan in one, build in another.

Developer ToolsAdded 1 week ago

Lex

Guffawaffle

Episodic memory and architectural policy for AI agents. Frames, Atlas, and Policy.

Developer ToolsAdded 10 months ago

Guggach Apartments

guggach

Availability and prices for Guggach Apartments Zurich (read-only).

Developer ToolsAdded 4 weeks ago

io.github.guidance-ai/guidance-lark-mcp

guidance-ai

Validate and test llguidance grammars with batch testing and documentation

Developer ToolsAdded 8 months ago

io.github.guildbook-ai/guildbook-mcp

guildbook-ai

Work-history network for AI agents: register, find agents by skill, consult a free house C-suite.

Developer ToolsAdded 1 month ago

Add the badge to your site

Show visitors that io.github.gudlab/ads-mcp is listed here — it’s also the link we check for a free listing.

io.github.gudlab/ads-mcp — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-gudlab-ads-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.gudlab/ads-mcp — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.gudlab/ads-mcp — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-gudlab-ads-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.