Google Ads MCP by InsightfulPipe

السجل الرسمي التسويق والمبيعات

Hosted Google Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http google-ads-mcp-by-insightfulpipe 'https://google-ads.insightfulmcp.com/'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "google-ads-mcp-by-insightfulpipe": {
            "type": "http",
            "url": "https://google-ads.insightfulmcp.com/"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Google Ads MCP Server by Insightful Pipe
  2. MCP Server URL
  3. What is Google Ads MCP?
  4. Installation
  5. Available Actions
  6. Control What Your AI Can Do
  7. Usage Examples
  8. Supported Campaign Types
  9. Why Use Google Ads MCP?
  10. Security & Privacy
  11. Pricing
  12. Ready-Made Skills and Prompts
  13. Explore More MCP Servers by Insightful Pipe
  14. Resources
  15. Support
  16. License

Google Ads MCP Server by Insightful Pipe

Connect Google Ads to AI assistants for advertising analytics and campaign management.

Part of the Insightful Pipe MCP Server Collection — Connect your Google Ads account to Claude, ChatGPT, Cursor, and other AI assistants using the Model Context Protocol (MCP). Analyze campaigns, optimize ad spend, and get AI-driven insights directly in your conversations.

MCP Server URL

https://google-ads.insightfulmcp.com/

What is Google Ads MCP?

Google Ads MCP is a remote Model Context Protocol server that enables AI assistants to interact with your Google Ads data. This MCP integration allows you to:

  • Query campaign performance metrics using natural language
  • Analyze ad group and keyword performance
  • Get AI-powered recommendations for campaign optimization
  • Monitor ROAS, CTR, CPC, and conversion metrics
  • Create and manage campaigns, ad groups, and keywords
  • Execute custom GAQL queries for advanced reporting

Installation

Claude
  1. Copy the MCP Server URL: https://google-ads.insightfulmcp.com/
  2. Open Claude Connectors Settings
  3. Scroll to the bottom and click Add custom connector
  4. Paste the URL and click Add
  5. Click Connect and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.
ChatGPT

Custom MCP servers are added through ChatGPT's Developer mode. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.

  1. Turn on Developer mode in ChatGPT settings
  2. Create a new app for a remote MCP server and paste the URL: https://google-ads.insightfulmcp.com/
  3. Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.

See OpenAI's guide: Developer mode and MCP apps in ChatGPT

Claude Code
claude mcp add --transport http google-ads https://google-ads.insightfulmcp.com/
Cursor

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "google-ads": {
      "url": "https://google-ads.insightfulmcp.com/"
    }
  }
}

When Cursor shows Needs authentication, click Connect and sign in to InsightfulPipe if asked.

Gemini CLI
gemini mcp add --transport http google-ads https://google-ads.insightfulmcp.com/

Available Actions

99 actions: 37 read, 62 write.

Read Actions (37)

Show all 37 read actions

ActionDescription
account_performance_reportAccount performance for a date range: clicks, cost, impressions, conversions and all conversions
ad_performance_reportAd performance for a date range: status, clicks, cost, impressions and conversions per ad
bidding_strategy_reportPortfolio bidding strategy performance for a date range: type, status, clicks, cost, cost per conversion, impressions, average CPC and conversions
campaign_performance_reportCampaign performance for a date range: status, bidding strategy type, clicks, cost, impressions, conversions and all conversions
dsa_search_terms_reportDynamic Search Ads search terms: headline and landing page served, clicks, cost, impressions and conversions
gaqlExecute a GAQL (Google Ads Query Language) query
generate_keyword_ideasGenerate keyword ideas from seed keywords or URL using Keyword Planner
get_account_infoCustomer account information and settings
get_ad_group_biddingAd group bidding strategy information
get_ad_group_labelsAd group label associations
get_ad_groupsAd group performance data and configuration
get_ad_labelsAd group ad label associations
get_adsAd creative performance data and policy information
get_audiencesAudience targeting and demographic performance data
get_campaign_biddingCampaign bidding strategy configurations
get_campaign_budgetsCampaign budget configuration and recommendations
get_campaign_labelsCampaign label associations
get_campaignsCampaign performance data and configuration
get_change_historyChange status history for Google Ads entities
get_clicksClick-level performance and location data
get_client_accountsCustomer client hierarchy and management information
get_criterion_labelsAd group criterion label associations
get_customer_labelsCustomer label associations
get_display_keywordsDisplay keyword targeting performance
get_geo_performanceGeographic and location-based performance data
get_keywordsKeyword performance data and statistics
get_labelsLabel management and organization data
get_non_manager_accountsCustomer client non-manager accounts only
get_shopping_performanceShopping campaign product-level performance data
get_topicsTopic targeting performance data
get_user_interestsUser interest categories and availability
get_user_locationsUser location-based performance data
keyword_performance_reportKeyword performance for a date range: status, first-page, first-position and top-of-page CPC estimates
list_bidding_strategiesList portfolio bidding strategies with type, status, targets, bid limits and attached campaign counts
list_conversion_actionsList conversion actions (id, name, type, category, status); pass conversion_action_id for one with its tag snippets
search_terms_reportSearch terms that triggered ads: match type, clicks, cost, impressions and conversions
suggest_geo_targetsSearch for geo target constants by name (city, postal code, region) to get IDs for location targeting
Write Actions (62)

Show all 62 write actions

ActionDescription
add_audience_targetingTarget a user list (remarketing audience) with an ad group
add_call_assetAdd a phone call asset to the account (shows phone number with ads)
add_callout_assetAdd callout text snippets to the account or to a campaign (e.g., 'Free Shipping', '24/7 Support')
add_demographic_targetingAdd age and/or gender demographic targeting to an ad group
add_dsa_webpage_targetingAdd a webpage-targeting criterion to a DSA ad group (incl. page-feed label targeting)
add_keywordsAdd keywords to an ad group
add_labelCreate a new label for organizing campaigns, ad groups, and ads
add_lead_form_assetAdd a lead form to a campaign (users submit info directly from the ad)
add_location_targetingAdd geographic location targeting to a campaign (countries, cities, postal codes, regions)
add_negative_keywordsAdd negative keywords at campaign or ad group level
add_price_assetAdd a price asset to the account (shows product/service pricing under ads)
add_proximity_targetingAdd radius/proximity targeting to a campaign (target users within a radius around coordinates)
add_sitelinksAdd sitelink assets to a campaign (clickable links below the ad)
add_structured_snippet_assetAdd a structured snippet to a campaign (category-based highlights)
apply_labelApply a label to campaigns, ad groups, or ads
attach_conversion_actions_to_campaignBind specific conversion actions to an App campaign via Campaign.selective_optimization
create_ad_groupCreate a new ad group (always created as PAUSED)
create_app_adCreate an App ad in an existing App campaign ad group
create_app_campaignCreate an App campaign with its initial App ad group (always created as PAUSED)
create_app_deep_link_assetCreate an app deep link asset for App ads
create_asset_groupAdd an asset group to an existing Performance Max campaign
create_bidding_strategyCreate a portfolio bidding strategy (Target CPA, Target ROAS, Maximize Conversions or Maximize Conversion Value) that campaigns share
create_campaignCreate a new campaign (always created as PAUSED)
create_conversion_actionCreate a conversion action to track valuable user actions
create_display_campaignCreate a Display campaign with ad group and responsive display ad in one atomic request
create_dsa_campaignCreate a Dynamic Search Ads (DSA) Search campaign (always created as PAUSED)
create_dynamic_search_adCreate a Dynamic Search Ad in a DSA ad group (always created as PAUSED)
create_page_feedCreate a DSA page feed (AssetSet of type PAGE_FEED) with page URLs and labels
create_performance_max_campaignCreate a Performance Max campaign with asset group in one atomic request
create_responsive_display_adCreate a responsive display ad (always created as PAUSED)
create_responsive_search_adCreate a responsive search ad (always created as PAUSED)
create_search_campaignCreate a new Search campaign (always created as PAUSED)
create_user_listCreate a new user list (remarketing audience) for Customer Match
create_youtube_video_assetCreate a reusable YouTube video asset by video ID
link_asset_group_assetsAttach existing assets to a Performance Max asset group
link_page_feed_to_campaignLink a page-feed asset set to a DSA campaign (CampaignAssetSet)
pause_adPause an individual ad
pause_ad_groupPause an ad group
remove_customer_list_membersRemove members from a Customer Match user list
remove_keywordsRemove keywords from an ad group
remove_negative_keywordsRemove negative keywords at campaign or ad group level
resume_adResume (enable) a paused ad
resume_ad_groupResume (enable) a paused ad group
set_asset_group_listing_filtersChoose which Merchant Center products a Performance Max asset group advertises
set_campaign_device_targetingTarget or exclude a device for a whole campaign, including Demand Gen
set_device_bid_modifierSet bid adjustment for a specific device type on an ad group
unlink_asset_group_assetsDetach assets from a Performance Max asset group
update_adUpdate an ad's status (enabled, paused, removed)
update_ad_groupUpdate an ad group: name, bids, targets, rotation, URL settings, or status (enabled, paused, removed)
update_app_adUpdate an existing App ad's inline text and referenced assets
update_asset_groupUpdate a Performance Max asset group: name, landing pages, or status (enabled, paused, removed)
update_asset_group_signalsAdd or remove audience and search theme signals on an existing asset group
update_bidding_strategyUpdate a portfolio bidding strategy: name, target, bid limits, or remove it
update_campaignUpdate a campaign: name, dates, budget, bidding strategy and targets, network settings, geo target type, URL settings, or status (enabled, paused, removed)
update_campaign_targetingAdd or remove the locations and languages a campaign targets
update_conversion_actionUpdate an existing conversion action's settings
update_keywordsUpdate existing keywords (status, bids)
update_responsive_search_adUpdate an existing responsive search ad's headlines, descriptions, or URLs
upload_click_conversionsUpload offline click conversions (Enhanced Conversions for Leads)
upload_customer_listUpload members to a Customer Match user list (remarketing audience)
upload_image_assetUpload an image asset from a URL to Google Ads
upload_media_bundle_assetUpload an HTML5 media bundle asset from a ZIP URL

Control What Your AI Can Do

You decide what AI agents can do with each connected account:

  • Turn individual actions on or off for every connected account, so agents only see the actions you allow.
  • Connect as Read-only or Read & Write. A read-only connection can only enable read actions.
  • Destructive actions stay off by default. Actions such as deletes are disabled until an admin enables them.
  • Team access per account. Restricted team members only use the accounts they are granted, with the read actions enabled on them.

New Google Ads campaigns, ad groups and ads are created paused, so nothing goes live until you enable it.

Usage Examples

Query Campaign Performance
"Show me my Google Ads campaign performance for the last 30 days"
Analyze Keywords
"What are my top 10 performing keywords by conversion rate?"
Generate Keyword Ideas
"Generate keyword ideas for 'running shoes' using Keyword Planner"
Execute Custom GAQL Query
"Run a GAQL query to get campaign metrics grouped by device"
Create Campaign
"Create a new search campaign called 'Summer Sale' with a $50 daily budget"
Add Keywords
"Add 'best running shoes' as a phrase match keyword to my Running campaign"

Supported Campaign Types

  • Search Campaigns - Text ads on Google Search
  • Display Campaigns - Visual ads across the Google Display Network
  • Shopping Campaigns - Product listing ads
  • Video Campaigns - YouTube and video partner ads
  • Performance Max - AI-powered cross-channel campaigns
  • App Campaigns - Mobile app promotion

Why Use Google Ads MCP?

For Marketers
  • Save time - Query data without logging into Google Ads
  • Natural language - No need to learn complex reporting interfaces
  • AI insights - Get recommendations you might have missed
For Agencies
  • Multi-account management - Query across client accounts
  • Automated reporting - Generate client reports conversationally
  • Scalable analysis - Analyze more data in less time
For Developers
  • MCP standard - Built on the open Model Context Protocol
  • Easy integration - Works with any MCP-compatible AI assistant
  • Full API access - Both read and write operations supported

Security & Privacy

  • OAuth 2.0 - Secure authentication with Google
  • Granular permissions - Control read vs write access
  • Data encryption - All data transmitted securely

Pricing

The Google Ads MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month, and you can try it for 7 days. See insightfulpipe.com/pricing for current plans.

Ready-Made Skills and Prompts

Explore More MCP Servers by Insightful Pipe

Visit insightfulpipe.com/mcp-servers to discover our full collection of MCP servers for marketing and analytics.

Advertising MCP Servers
Analytics MCP Servers

View All MCP Servers →

Resources

Support


Insightful Pipe — AI-powered marketing analytics through MCP servers. Explore all integrations →

License

MIT License - see LICENSE for details.

الأسئلة الشائعة

ما هو Google Ads MCP by InsightfulPipe؟

Hosted Google Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.

كيف أثبّت Google Ads MCP by InsightfulPipe؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http google-ads-mcp-by-insightfulpipe 'https://google-ads.insightfulmcp.com/'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Google Ads MCP by InsightfulPipe إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Google Ads MCP by InsightfulPipe مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Google Ads MCP by InsightfulPipe؟

ينشره Insightful-Pipe. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.