Explore performance, research keywords and prepare campaign changes from your MCP client.
Google Ads is an MCP project maintained in the get-mcp-ads/google-ads-mcp-server repository. The maintainer describes its purpose as “Explore performance, research keywords and prepare campaign changes from your MCP client”. Read the project documentation for the complete scope.
The documented npm package is @getmcpads/google-ads-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-09.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| google_ads_list_accounts | List Google Ads customer accounts accessible with the current credentials. |
| google_ads_get_account_details | Get detailed information for a specific Google Ads customer account. |
| google_ads_run_gaql | Execute a raw GAQL (Google Ads Query Language) query. |
| google_ads_get_insights | Query Google Ads performance insights with intelligent query planning. |
| google_ads_get_campaigns | List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy. |
| google_ads_get_adgroups | List ad groups for a Google Ads account, optionally filtered by campaign. |
| google_ads_get_keyword_performance | Get keyword-level performance data from keyword_view resource. |
| google_ads_validate_query | Validate metric/dimension/resource compatibility BEFORE executing a query. |
| google_ads_health_check | Read-only connectivity check. |
| google_ads_get_account_hierarchy | List accessible customers and, where possible, manager/client relationships from GAQL customer_client. |
| google_ads_get_conversion_actions | List conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported. |
| google_ads_get_change_events | Fetch recent change_event rows. |
| google_ads_get_recommendations | List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported. |
| google_ads_get_budgets | List campaign budgets with amount, status, delivery method, and recommended budget fields when supported. |
| google_ads_get_bidding_strategies | List portfolio bidding strategies. |
| google_ads_get_search_terms | Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType. |
| google_ads_get_landing_pages | Fetch landing_page_view performance with final URL, campaign/ad group context, traffic, conversion, and landing-page quality metrics when supported. |
| google_ads_get_pmax_assets | List Performance Max asset group assets from asset_group_asset with asset group/campaign context and optional date-range performance metrics. |
| google_ads_get_simulations | Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. |
| google_ads_get_paid_organic_search_terms | Read-only paid/organic search terms report. |
| google_ads_get_shopping_products | Read-only Merchant Center product catalog/eligibility report via shopping_product. |
| google_ads_get_shopping_performance | Read-only Shopping performance report keyed by Merchant Center product dimensions. |
| google_ads_get_pmax_placements | Read-only Performance Max placement diagnostics from performance_max_placement_view. |
| google_ads_get_pmax_asset_diagnostics | Read-only Performance Max asset group diagnostics. |
| google_ads_list_image_assets | List the account's image asset library (FROM asset) with stable, publicly served full-size URLs on tpc.googlesyndication.com, dimensions, file size, and mime… |
| google_ads_list_video_assets | List the account's YouTube video assets (FROM asset) with derived watch, embed, and public thumbnail URLs. |
| google_ads_get_demand_gen_assets | List Demand Gen ads (video responsive, multi-asset, carousel) with their referenced creatives resolved: stable image URLs and YouTube video IDs with embed and… |
| google_ads_generate_keyword_historical_metrics | Get Keyword Planner search-volume history for supplied keywords. |
| google_ads_generate_keyword_ideas | Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. |
| google_ads_generate_keyword_forecast_metrics | Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. |
| google_ads_search_fields | Search Google's live GoogleAdsField catalog. |
| google_ads_suggest_geo_targets | Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants. |
| google_ads_generate_ad_group_themes | Organize supplied keywords into existing Google Ads ad groups. |
| google_ads_run_readonly_rpc | Advanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights… |
| google_ads_get_video_upload | Read the processing state and YouTube video ID of one Google Ads upload in the selected customer. |
| google_ads_upload_video | Upload MP4/WebM/QuickTime bytes (max 16 MiB) to the Google-managed YouTube channel for the selected ad account. |
| google_ads_remove_video_upload | Remove a video upload owned by the selected ad account. |
| google_ads_apply_plan | Preview, validate and atomically apply a Google Ads v25 build/change plan: campaigns, budgets, ad groups, RSA/Display/Demand Gen ads, image/text/YouTube… |
| google_ads_update_campaign_status | Pause, re-enable or remove a Google Ads campaign. |
| google_ads_create_campaign | Create a Google Ads campaign. |
| google_ads_update_campaign_budget | Change the daily budget of a Google Ads campaign. |
| google_ads_rename_campaign | Rename a Google Ads campaign. |
| google_ads_update_campaign_schedule | Change the start or end date of a Google Ads campaign. |
| google_ads_update_adgroup_status | Pause, re-enable or remove a Google Ads ad group. |
| google_ads_update_adgroup_bid | Change the default CPC bid of a Google Ads ad group. |
| URI | Contents |
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/google-ads-mcp-server"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN",
"GOOGLE_ADS_CLIENT_ID": "your-client-id",
"GOOGLE_ADS_CLIENT_SECRET": "YOUR_GOOGLE_ADS_CLIENT_SECRET",
"GOOGLE_ADS_REFRESH_TOKEN": "YOUR_GOOGLE_ADS_REFRESH_TOKEN"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| GOOGLE_ADS_DEVELOPER_TOKEN | Declared in the maintainer’s client configuration. | Yes |
| GOOGLE_ADS_CLIENT_ID | Declared in the maintainer’s client configuration. | Yes |
| GOOGLE_ADS_CLIENT_SECRET | Declared in the maintainer’s client configuration. | Yes |
| GOOGLE_ADS_REFRESH_TOKEN | Declared in the maintainer’s client configuration. | Yes |
Search built for AI, not humans — semantic web search that returns model-ready content, plus code context.
Put 6,000+ pre-built scrapers at your assistant's fingertips through one MCP endpoint.
Fetches and analyzes content from Reddit, providing access to hot threads and post details.
Enables interaction with X (formerly Twitter) for retrieving tweets, creating new posts, and replying to existing ones.
Automates LinkedIn interactions and extracts data through browser automation, respecting terms of service and rate limits.
Automates SEO tasks and provides AI-powered optimization by integrating with the Google Ads Keyword Planner API.