Google Ad Manager

Provides an MCP server to automate Google Ad Manager tasks via AI, including campaigns, line items, creatives, and advertisers.

python

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "matiouscorp-google-ad-manager-mcp": {
      "command": "gam-mcp",
      "args": [],
      "env": {
        "GAM_MCP_HOST": "0.0.0.0 (HTTP mode only)",
        "GAM_MCP_PORT": "8000 (HTTP mode only)",
        "GAM_NETWORK_CODE": "YOUR_NETWORK_CODE",
        "GAM_MCP_TRANSPORT": "stdio or http (default: stdio)",
        "GAM_MCP_AUTH_TOKEN": "secure-token (optional; auto-generated if not set)",
        "GAM_CREDENTIALS_PATH": "/path/to/credentials.json (service account JSON)"
      }
    }
  }
}

This MCP server lets you control Google Ad Manager through natural language using AI assistants. You can create campaigns, upload creatives, manage orders and line items, and verify setups—without clicking through the Ad Manager UI.

How to use

Connect your AI assistant to the MCP server and start issuing natural language commands. You can perform end-to-end operations such as creating a new advertiser and campaign, uploading creatives, linking them to line items, and reviewing delivery status. Use simple, action-oriented prompts like: “Create a new campaign for Nike ending December 31st” or “Upload all creatives from this folder and associate them with the Display line item.” The system handles the orchestration across orders, line items, creatives, and advertisers, returning IDs and status updates as you go.

How to install

Prerequisites: you need Python installed on your system and a working MCP runtime environment. You will also use a command-line tool to run the server.

# Install from PyPI
pip install google-ad-manager-mcp

# Or run with the uv runner
uv pip install google-ad-manager-mcp

# Optional: install from source
# git clone https://github.com/MatiousCorp/google-ad-manager-mcp.git
# cd google-ad-manager-mcp
# pip install -e .

Run the server locally

Start the MCP server in your local environment. You can use the standard command or run via Python for development.

# Using the installed command
gam-mcp

# Or directly with Python
python -m gam_mcp.server

# With a custom configuration (example)
GAM_NETWORK_CODE=12345678 GAM_MCP_PORT=9000 gam-mcp

Available tools

list_delivering_orders

List all orders with delivering line items

get_order

Get order details by ID or name

create_order

Create a new order

find_or_create_order

Find existing or create new order

get_line_item

Get line item details

create_line_item

Create a new line item

duplicate_line_item

Duplicate an existing line item

update_line_item_name

Rename a line item

list_line_items_by_order

List all line items for an order

upload_creative

Upload an image creative

associate_creative_with_line_item

Associate creative with line item

upload_and_associate_creative

Upload and associate in one step

bulk_upload_creatives

Upload all creatives from a folder

get_creative

Get creative details

list_creatives_by_advertiser

List creatives for an advertiser

find_advertiser

Find advertiser by name

get_advertiser

Get advertiser details

list_advertisers

List all advertisers

create_advertiser

Create a new advertiser

find_or_create_advertiser

Find or create advertiser

verify_line_item_setup

Verify line item configuration

check_line_item_delivery_status

Check delivery progress

verify_order_setup

Verify entire order setup

create_campaign

Complete campaign creation workflow

Built by

VeilStrat

AI signals for GTM teams