Skip to content
Agentmart
Submit a tool

MCP Gads

Google Ads MCP server — query campaigns, keywords, assets & more via natural language

Connector by pijusz · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 1
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/pijusz-mcp-gads

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

Google Ads MCP server — query campaigns, keywords, assets & more via natural language

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, install config and code. Checked Oct 26, 2026.

Tools
36 read · 5 write · 0 delete
Secrets
None asked for
Install scripts
None found
Runs as
Node.js package

Tools by what they do 41

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

Read 36 · Look things up without changing anything.

  • analyze_image_assets
  • download_image_asset
  • execute_gaql_query
  • generate_keyword_ideas
  • get_account_currency
  • get_account_hierarchy
  • get_account_summary
  • get_ad_creatives
  • get_ad_group_performance
  • get_ad_performance
  • get_ad_schedule_performance
  • get_asset_group_performance
Show 24 more tools
  • get_asset_usage
  • get_audience_performance
  • get_budget_utilization
  • get_campaign_performance
  • get_change_history
  • get_conversion_actions
  • get_device_performance
  • get_gaql_help
  • get_geographic_performance
  • get_image_assets
  • get_impression_share
  • get_keyword_volumes
  • get_labels
  • get_landing_page_performance
  • get_paid_organic_search_terms
  • get_placement_performance
  • get_quality_scores
  • get_recommendations
  • get_search_term_insights
  • get_search_terms
  • get_video_performance
  • list_accounts
  • list_resources
  • run_gaql

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

  • add_negative_keywords
  • update_ad_group_status
  • update_ad_status
  • update_campaign_budget
  • update_campaign_status

Network hosts it talks to 5

  • api.github.com · found in code
  • biomejs.dev · found in code
  • github.com · found in code
  • googleads.googleapis.com · found in code
  • googleapis.com · found in code

Tools (41)

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

  • add_negative_keywords

    ⚠️ WRITE OPERATION: Add negative keywords to a campaign to prevent ads from showing for those search terms. This modifies your Google Ads account.

  • analyze_image_assetsread-only

    Analyze image asset performance with metrics like impressions, clicks, conversions, and CTR across campaigns.

  • download_image_assetread-only

    Download a specific image asset by ID to a local directory.

  • execute_gaql_queryread-only

    Execute a custom GAQL query and return results as a table. Use this for any ad-hoc Google Ads Query Language query.

  • generate_keyword_ideasread-only

    Generate keyword ideas using Google Ads Keyword Planner. Seed from keywords, a domain (seed_domain), or a page URL (seed_url). Domain and URL seeds work on sites you do not own — Google returns public information only — which makes this the supported way to research a competitor's keyword surface. Note it reports the keywords Google associates with that site, not proof the advertiser is bidding on them.

  • get_account_currencyread-only

    Get the currency code for a Google Ads account. Run this before analyzing cost data.

  • get_account_hierarchyread-only

    Get the MCC account tree showing manager-client relationships via customer_client resource.

  • get_account_summaryread-only

    Quick account dashboard: total metrics + top 5 campaigns by spend.

  • get_ad_creativesread-only

    Get ad creative details including RSA headlines, descriptions, and final URLs. Great for creative audits.

  • get_ad_group_performanceread-only

    Get ad group performance metrics. Optionally filter by campaign ID.

  • get_ad_performanceread-only

    Get ad-level performance metrics for the specified time period. RECOMMENDED WORKFLOW: 1. First run list_accounts() to get available account IDs 2. Then run get_account_currency() to see what currency the account uses 3. Finally run this command to get ad performance Note: Cost values are in micros (1,000,000 = 1 unit of currency).

  • get_ad_schedule_performanceread-only

    Performance breakdown by hour of day or day of week.

  • get_asset_group_performanceread-only

    Performance Max asset group metrics including ad strength and status.

  • get_asset_usageread-only

    Find where specific assets are being used in campaigns and ad groups.

  • get_audience_performanceread-only

    Performance breakdown by age range and gender demographics.

Show 26 more tools
  • get_budget_utilizationread-only

    Get campaign budget amounts vs actual spend to see budget utilization. Shows whether campaigns are limited by budget.

  • get_campaign_performanceread-only

    Get campaign performance metrics for the specified time period. RECOMMENDED WORKFLOW: 1. First run list_accounts() to get available account IDs 2. Then run get_account_currency() to see what currency the account uses 3. Finally run this command to get campaign performance Note: Cost values are in micros (1,000,000 = 1 unit of currency).

  • get_change_historyread-only

    Get recent account changes (campaign updates, bid changes, ad modifications, etc.) from the change_event resource.

  • get_conversion_actionsread-only

    List conversion actions with their settings and recent performance metrics.

  • get_device_performanceread-only

    Get campaign performance broken down by device type (desktop, mobile, tablet).

  • get_gaql_helpread-only

    Get a GAQL (Google Ads Query Language) reference guide with syntax, common resources, date filters, and example queries. Call this before writing custom GAQL queries.

  • get_geographic_performanceread-only

    Get campaign performance broken down by geographic location (country, region, city).

  • get_image_assetsread-only

    Retrieve all image assets in the account including their full-size URLs, dimensions, and file sizes.

  • get_impression_shareread-only

    Get competitive position metrics: impression share, top/absolute top IS, and lost IS (budget & rank).

  • get_keyword_volumesread-only

    Get historical search volume metrics for specific keywords. Returns exact volume data (unlike generate_keyword_ideas which suggests related keywords).

  • get_labelsread-only

    List labels and their assignments to campaigns or ad groups.

  • get_landing_page_performanceread-only

    Landing page URLs with performance metrics.

  • get_paid_organic_search_termsread-only

    Compare paid and organic performance for the same search queries. Shows ad clicks next to Search Console organic clicks per query, so you can spot terms you already rank for organically and may be overpaying to advertise on. Requires the Google Ads account to be linked to Search Console.

  • get_placement_performanceread-only

    Where Display and Performance Max ads appeared (websites, apps, YouTube channels).

  • get_quality_scoresread-only

    Get keyword quality scores with component breakdown (expected CTR, ad relevance, landing page experience).

  • get_recommendationsread-only

    Get Google's AI-powered optimization recommendations for the account (bid adjustments, keyword suggestions, budget changes, etc.).

  • get_search_term_insightsread-only

    Search demand categories for a campaign — the only way to see what Performance Max and Demand Gen campaigns actually matched, since those never appear in get_search_terms. Called with just campaign_id it returns categories with a bucketed monthly search_volume for each. Pass category_id (an id from a previous call) to drill into the individual search terms inside one category; search volume is not available at that level.

  • get_search_termsread-only

    Get actual search queries that triggered your ads (search term report). Shows what users are really searching for.

  • get_video_performanceread-only

    YouTube and video ad performance metrics including view rates and quartile completion.

  • list_accountsread-only

    Lists all accessible Google Ads accounts. Run this first to discover account IDs.

  • list_resourcesread-only

    List valid Google Ads API resources that can be used in GAQL FROM clauses.

  • run_gaqlread-only

    Execute any GAQL query with output format options (table, json, csv). The most powerful tool for custom Google Ads data queries. EXAMPLE QUERIES: Campaign metrics: SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_7_DAYS Ad group perf: SELECT ad_group.name, metrics.conversions, metrics.cost_micros, campaign.name FROM ad_group WHERE metrics.clicks > 100 Keyword analysis: SELECT keyword.text, metrics.ctr FROM keyword_view ORDER BY metrics.impressions DESC Note: Cost values are in micros (1,000,000 = 1 unit o…

  • update_ad_group_status

    ⚠️ WRITE OPERATION: Pause or enable an ad group. This modifies your Google Ads account.

  • update_ad_status

    ⚠️ WRITE OPERATION: Pause or enable an ad. This modifies your Google Ads account.

  • update_campaign_budget

    ⚠️ WRITE OPERATION: Change the daily budget amount for a campaign. Amount is in micros (1,000,000 = 1 unit of currency). This modifies your Google Ads account.

  • update_campaign_status

    ⚠️ WRITE OPERATION: Pause or enable a campaign. This modifies your Google Ads account.

Compare and alternatives

    Featured in

    Signals

    Stars
    1
    Forks
    0
    Open issues
    1
    Last commit
    Oct 22, 2026 (6 days ago)
    Last release
    Oct 22, 2026 (6 days ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.pijusz/mcp-gads
    Version
    0.5.4
    Auth
    No auth
    Packages
    npm mcp-gads
    License
    MIT
    Repository
    github.com/pijusz/mcp-gads
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql

    More from pijusz

    Cite this page

    MCP Gads. Agent Mart. https://agentmart.dev/connectors/pijusz-mcp-gads (last updated 2026-10-24)