Skip to main content
Glama

Google Ads MCP Server

This is a Model Context Protocol (MCP) server for the Google Ads Transparency Center.

With this you can search Google's public ads transparency center for any company or brand, see what they're currently running and analyze their advertising. You can analyze ad images/text, analyze video ads with comprehensive insights, compare companies' strategies, and get insights into what's working in their campaigns.

Here's an example of what you can do when it's connected to Claude.

https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee

To get updates on this and other projects we work on subscribe here

PS: Join our Twitter community for all things MCP


Example Prompts

How many ads is 'AnthropicAI' running? What's their split across video and image?
What messaging is 'AnthropicAI' running right now in their ads?
Analyze the video ads from 'Nike' and extract their visual storytelling strategy, pacing, and brand messaging techniques.
Do a deep comparison to the messaging between 'AnthropicAI', 'Perplexity AI' and 'OpenAI'. Give it a nice forwardable summary.

Installation

Prerequisites

  • Python 3.12+
  • Anthropic Claude Desktop app (or Cursor)
  • Pip (Python package manager), install with python -m pip install
  • An access token for Scrape Creators
  • A Google Gemini API key for video analysis (optional, only needed for video ads)
  1. Clone and run the install script
    git clone https://github.com/trypeggy/google-ads-library-mcp.git cd google-ads-library-mcp # For macOS/Linux: ./install.sh # For Windows: install.bat
  2. Configure your API keysEdit the .env file that was created and add your API keys:
  3. Follow the displayed MCP configurationThe install script will show you the exact configuration to add to Claude Desktop or Cursor.

Manual Install

If you prefer to install manually:

  1. Clone this repository
    git clone https://github.com/trypeggy/google-ads-library-mcp.git cd google-ads-library-mcp
  2. Install dependencies
    pip install -r requirements.txt
  3. Configure API keysCopy the template and configure your API keys:
    cp .env.template .env # Then edit .env with your actual API keys
    To obtain API keys:
    • Sign up for Scrape Creators here
    • Get a Google Gemini API key here (optional, for video analysis)
  4. Connect to the MCP serverAdd the MCP server configuration to your Claude Desktop or Cursor config:
    { "mcpServers": { "google_ad_library": { "command": "/usr/local/opt/python@3.13/bin/python3", "args": [ "{{PATH_TO_PROJECT}}/google-ads-library-mcp/mcp_server.py" ] } } }
    Replace {{PATH_TO_PROJECT}} with the full path to where you cloned this repository.Note: API keys are automatically loaded from the .env file. Command line arguments are still supported and take priority over environment variables if provided.For Claude Desktop:Save this as claude_desktop_config.json in your Claude Desktop configuration directory at:
    ~/Library/Application Support/Claude/claude_desktop_config.json
    For Cursor:Save this as mcp.json in your Cursor configuration directory at:
    ~/.cursor/mcp.json
  5. Restart Claude Desktop / CursorOpen Claude Desktop and you should now see the Google Ads Library as an available integration.Or restart Cursor.

Technical Details

  1. Claude sends requests to the Python MCP server
  2. The MCP server queries the ScrapeCreators API for Google Ads Transparency Center data
  3. Data flows back through the chain to Claude

This server connects to Google's Ads Transparency Center:

  • Google Ads: Uses company domain (e.g., "nike.com") or advertiser ID for search
  • Response Format: Returns ads with format types (text/image/video) and detailed variations
  • Ad Details: Each ad can have multiple variations with different headlines and descriptions
  • Regional Data: Includes region-specific statistics and impression data

Tips:

  • Use company domains (e.g., "nike.com") instead of brand names for searching
  • Text ads are now supported in addition to image and video ads
  • Each ad may have multiple variations with different headlines and descriptions

Available MCP Tools

This MCP server provides tools for interacting with Google Ads Transparency Center objects:

Tool NameDescription
get_google_adsRetrieves currently running ads for a company from Google Ads Transparency Center (by domain or advertiser ID)
get_google_ad_detailsGets detailed information about a specific Google ad, including all variations and regional stats
analyze_ad_imageDownloads and analyzes ad images for visual elements, text, colors, and composition
analyze_ad_videoDownloads and analyzes ad videos using Gemini AI for comprehensive video insights
get_cache_statsGets statistics about cached media (images and videos) and storage usage
search_cached_mediaSearches previously analyzed media by brand, colors, people, or media type
cleanup_media_cacheCleans up old cached media files to free disk space

Troubleshooting

Common Issues

API Key Not Found Error:

  • Ensure your .env file is in the project root directory
  • If you don't have a .env file, copy it from the template: cp .env.template .env
  • Check that your API keys are correctly formatted without quotes
  • Verify the .env file contains SCRAPECREATORS_API_KEY=your_key_here
  • For video analysis, ensure GEMINI_API_KEY=your_key_here is also added

Video Analysis Not Working:

  • Confirm you have a valid Google Gemini API key in your .env file
  • Video analysis requires the GEMINI_API_KEY environment variable

MCP Server Connection Issues:

  • Verify the path in your MCP configuration points to the correct location
  • Make sure you've installed all dependencies with pip install -r requirements.txt
  • Restart Claude Desktop/Cursor after configuration changes

For additional Claude Desktop integration troubleshooting, see the MCP documentation. The documentation includes helpful tips for checking logs and resolving common issues.

Google Ads Specific Notes:

  • Use company domains (e.g., "nike.com") instead of brand names for searching
  • Text ads are now supported in addition to image and video ads
  • Each ad may have multiple variations with different headlines and descriptions

Feedback

Your feedback will be massively appreciated. Please tell us which features on that list you like to see next or request entirely new ones.


License

This project is licensed under the MIT License.

License Python

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

This MCP server searches Google's public ads database and uses AI to analyze ad images/videos, with intelligent caching for performance.

  1. Example Prompts
    1. Installation
      1. Prerequisites
      2. Quick Install (Recommended)
      3. Manual Install
    2. Technical Details
      1. Google Ads
      2. Available MCP Tools
    3. Troubleshooting
      1. Common Issues
    4. Feedback
      1. License

        Related MCP Servers

        • A
          security
          F
          license
          A
          quality
          An MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.
          Last updated -
          3
          28
          82
          TypeScript
        • -
          security
          F
          license
          -
          quality
          MCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.
          Last updated -
        • -
          security
          F
          license
          -
          quality
          An MCP server that provides access to Google's API Discovery Service, allowing agents to discover and interact with Google APIs through natural language commands.
          Last updated -
          Python
          • Linux
          • Apple
        • -
          security
          F
          license
          -
          quality
          An MCP server that enables interaction with Google's Display & Video 360 advertising platform API, allowing management of digital advertising campaigns through natural language commands.
          Last updated -
          Python
          • Linux
          • Apple

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/talknerdytome-labs/google-ads-library-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server