google-tag-manager-mcp

# Google Tag Manager MCP Server

**Built by [Growthers.io](https://growthers.io?utm_source=github&utm_medium=readme&utm_campaign=githubmcpgtm)** — Data-driven growth agency.

An open-source MCP (Model Context Protocol) server that gives AI agents full access to the Google Tag Manager API v2.

Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client. Manage accounts, containers, workspaces, tags, triggers, variables, consent mode, and container versions — all from your AI assistant.

No external services required. Runs locally on your machine using your own Google credentials.

## Prerequisites

- Python 3.10+
- [pipx](https://pipx.pypa.io/) (recommended) or pip
- A Google Cloud project with the **Tag Manager API** enabled
- [gcloud CLI](https://cloud.google.com/sdk/docs/install) for credential setup

## Setup

### 1. Enable the Tag Manager API

1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Select or create a project
3. Go to **APIs & Services > Enable APIs**
4. Search for **Tag Manager API** and enable it

### 2. Authenticate

```bash
gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/tagmanager.readonly,https://www.googleapis.com/auth/tagmanager.edit.containers,https://www.googleapis.com/auth/tagmanager.edit.containerversions"
```

This creates a credentials file at `~/.config/gcloud/application_default_credentials.json`.

> **Tip:** If the default gcloud client blocks some scopes, create a custom OAuth Client ID in your Google Cloud project (APIs & Services > Credentials > Create OAuth Client > Desktop App), then use `--client-id-file=<path-to-client-secret.json>` with the command above.

### 3. Install

#### Option A: With pipx (recommended)

```bash
pipx install git+https://github.com/CarC96/google-tag-manager-mcp.git
```

#### Option B: From source

```bash
git clone https://github.com/CarC96/google-tag-manager-mcp.git
cd google-tag-manag