Skip to content
Agentmart
Submit a tool

Ads MCP

MCP server for Google Ads and Meta Ads.

Connector by gudlab · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/gudlab-ads-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
15 read · 20 write · 1 delete
Secrets
6 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 36

Read from the source code; the running server may list different tools.

Read 15 · Look things up without changing anything.

  • google_ads_get_campaign_structure
  • google_ads_list_campaigns
  • meta_ads_estimate_audience
  • meta_ads_get_account
  • meta_ads_get_ad
  • meta_ads_get_ad_set
  • meta_ads_get_ad_status
  • meta_ads_get_campaign
  • meta_ads_get_campaign_structure
  • meta_ads_get_insights
  • meta_ads_list_ad_sets
  • meta_ads_list_ads
Show 3 more tools
  • meta_ads_list_ads_by_status
  • meta_ads_list_campaigns
  • meta_ads_search_targeting

Write 20 · Create, change, send or run things.

  • google_ads_add_keywords
  • google_ads_add_negative_keywords
  • google_ads_create_search_campaign
  • google_ads_set_campaign_status
  • google_ads_set_keyword_status
  • google_ads_update_bid_strategy
  • meta_ads_copy_ad
  • meta_ads_copy_ad_set
  • meta_ads_copy_campaign
  • meta_ads_create_ad
  • meta_ads_create_ad_creative
  • meta_ads_create_ad_set
Show 8 more tools
  • meta_ads_create_campaign
  • meta_ads_set_ad_set_status
  • meta_ads_set_ad_status
  • meta_ads_set_campaign_status
  • meta_ads_update_ad
  • meta_ads_update_ad_set
  • meta_ads_update_campaign
  • meta_ads_upload_image

Delete 1 · Delete, drop, revoke or wipe things.

  • google_ads_remove_keywords

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • GOOGLE_ADS_CLIENT_ID
  • GOOGLE_ADS_CLIENT_SECRET
  • GOOGLE_ADS_DEVELOPER_TOKEN
  • GOOGLE_ADS_REFRESH_TOKEN
  • META_ACCESS_TOKEN
  • META_APP_SECRET

Other settings (environment variables or headers).

  • GOOGLE_ADS_CUSTOMER_ID
  • GOOGLE_ADS_LOGIN_CUSTOMER_ID
  • META_AD_ACCOUNT_ID
  • META_APP_ID

Tools (36)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • google_ads_add_keywordsAdd keywords to a Google Ads ad group

    Add keywords to an existing ad group

  • google_ads_add_negative_keywordsAdd Google Ads negative keywords

    Add campaign-level negative keywords

  • google_ads_create_search_campaignCreate Google Ads Search campaign (paused)

    Create a new Search campaign with ad groups, keywords and RSAs. Always created PAUSED.

  • google_ads_get_campaign_structureGet Google Ads campaign structureread-only

    Get a campaign's ad groups, keywords, ads, and negatives

  • google_ads_list_campaignsList Google Ads campaignsread-only

    List campaigns with status and budget

  • google_ads_remove_keywordsPermanently remove Google Ads keywordscan change or delete data

    Permanently remove keywords. Requires confirm_delete: true.

  • google_ads_set_campaign_statusEnable or pause a Google Ads campaign

    Enable or pause a campaign. The only Google tool that can turn spend on.

  • google_ads_set_keyword_statusPause or enable Google Ads keywords

    Pause or enable keywords (reversible)

  • google_ads_update_bid_strategyUpdate Google Ads bid strategy

    Change a campaign's bidding strategy

  • meta_ads_copy_adCopy a Meta ad (paused)

    Duplicate an ad, optionally into another ad set. Copy is always PAUSED.

  • meta_ads_copy_ad_setCopy a Meta ad set (paused)

    Duplicate an ad set (optional deep copy of ads). Copy is always PAUSED.

  • meta_ads_copy_campaignCopy a Meta campaign (paused)

    Duplicate a campaign (optional deep copy of ad sets/ads). Copy is always PAUSED.

  • meta_ads_create_adCreate a Meta ad (paused)

    Create a paused ad under an ad set with an existing creative. Does not start spend.

  • meta_ads_create_ad_creativeCreate a Meta ad creative

    Create a link creative (Page, image hash, primary text, headline, description, CTA, url_tags for UTMs). Does not create or activate an ad.

  • meta_ads_create_ad_setCreate a Meta ad set (paused)

    Create a paused ad set with daily budget, optimization, pixel+event, and manual targeting (geo, age, flexible_spec interests/behaviours, exclusions). Advantage+ audience is OFF unless advantage_audience is true.

Show 21 more tools
  • meta_ads_create_campaignCreate a Meta campaign (paused)

    Create a campaign (objective, special_ad_categories, optional campaign budget). Always created PAUSED. Does not start spend.

  • meta_ads_estimate_audienceEstimate Meta audience sizeread-only

    Delivery / reach estimate for a targeting spec (manual interests, Advantage+ off by default)

  • meta_ads_get_accountGet Meta ad account and token statusread-only

    Read the default (or given) ad account and, when META_APP_ID/SECRET are set, debug the System User token (scopes, expiry). Use this first to confirm auth.

  • meta_ads_get_adGet a Meta adread-only

    Get one ad with creative details, status, issues_info and ad_review_feedback

  • meta_ads_get_ad_setGet a Meta ad setread-only

    Get one ad set: targeting, promoted_object, budgets, optimization, review issues

  • meta_ads_get_ad_statusGet a Meta ad's review statusread-only

    Get an ad's review status and rejection reason if any (issues_info / ad_review_feedback)

  • meta_ads_get_campaignGet a Meta campaignread-only

    Get one campaign's status, budget, objective and issues_info

  • meta_ads_get_campaign_structureGet Meta campaign structureread-only

    Get a campaign plus its ad sets (targeting, budgets) and ads (creative + review feedback)

  • meta_ads_get_insightsGet Meta Ads insightsread-only

    Account, campaign, ad set or ad insights: spend, impressions, reach, clicks, CTR, CPC, CPM, actions and cost per action. Date presets or since/until. Optional breakdowns: age, gender, placement, day.

  • meta_ads_list_ad_setsList Meta ad setsread-only

    List ad sets for an account or campaign, including targeting and Advantage+ audience flag

  • meta_ads_list_adsList Meta adsread-only

    List ads for an account, campaign, or ad set, including creative and review feedback

  • meta_ads_list_ads_by_statusList Meta ads by review statusread-only

    List ads in an account filtered by effective_status (e.g. DISAPPROVED)

  • meta_ads_list_campaignsList Meta Ads campaignsread-only

    List Meta campaigns with status, effective_status, objective, budget and issues_info

  • meta_ads_search_targetingSearch Meta targetingread-only

    Search interests, behaviours, or geo locations by keyword. Use the returned ids in meta_ads_create_ad_set.

  • meta_ads_set_ad_set_statusActivate or pause a Meta ad set

    Set an ad set to ACTIVE or PAUSED. ACTIVE can start spend if the parent campaign and child ads are ACTIVE. Create/copy tools never activate.

  • meta_ads_set_ad_statusActivate or pause a Meta ad

    Set an ad to ACTIVE or PAUSED. ACTIVE can start spend if the campaign and ad set are ACTIVE and the ad passes review. Create/copy tools never activate.

  • meta_ads_set_campaign_statusActivate or pause a Meta campaign

    Set a campaign to ACTIVE or PAUSED. ACTIVE is the spend switch for the campaign (ad sets and ads must also be ACTIVE). Create/copy tools never activate.

  • meta_ads_update_adUpdate a Meta ad or its copy

    Rename an ad, attach a creative_id, or change copy (creates a replacement creative). Does not change status.

  • meta_ads_update_ad_setUpdate a Meta ad set

    Update targeting, budget or optimization. Does not change status.

  • meta_ads_update_campaignUpdate a Meta campaign

    Update name, budget or special_ad_categories. Does not change status.

  • meta_ads_upload_imageUpload a Meta ad image

    Upload an image from a public URL or local path to the ad account image library. Returns the image hash.

Signals

Stars
0
Forks
0
Open issues
0
Weekly downloads
6
Last commit
Oct 24, 2026 (5 days ago)
Last release
Sep 22, 2026 (1 month ago)
Last package publish
Sep 22, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.gudlab/ads-mcp
Version
0.1.1
Auth
API key
Packages
npm @gudlab/ads-mcp
License
MIT
Repository
github.com/gudlab/ads-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from gudlab

Cite this page

Ads MCP. Agent Mart. https://agentmart.dev/connectors/gudlab-ads-mcp (last updated 2026-10-24)