Google Tag Manager MCP Server
Built by Growthers.io — 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 (recommended) or pip
- A Google Cloud project with the Tag Manager API enabled
- gcloud CLI for credential setup
Setup
1. Enable the Tag Manager API
- Go to Google Cloud Console
- Select or create a project
- Go to APIs & Services > Enable APIs
- 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=` 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-manager-mcp
pip install .
### 4. Configure your MCP client
Add to your MCP client configuration (e.g. `~/.claude.json` for Claude Code):```json
{
"mcpServers": {
"gtm-mcp": {
"type": "stdio",
"command": "pipx",
"args": ["run", "gtm-mcp"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "<path-to>/application_default_credentials.json"
}
}
}
}
Replace ` with the actual path to your credentials file (typically~/.config/gcloud/application_default_credentials.json`).
How it works
Despite the name "server", this runs as a local process on your machine. Your MCP client launches it as a subprocess and communicates via stdin/stdout. No network ports are opened, no cloud hosting is needed — it's essentially a plugin.MCP Client (Claude Code, etc.) ←— stdin/stdout —→ gtm-mcp (local process) ——→ Google Tag Manager API
Available Tools (30)
Accounts
| Tool | Description |
|---|---|
list_accounts |
List all GTM accounts |
get_account |
Get account details |
list_user_permissions |
List permissions for an account |
Containers
| Tool | Description |
|---|---|
list_containers |
List all containers in an account |
get_container |
Get container details |
get_container_snippet |
Get the install snippet for a website |
Workspaces
| Tool | Description |
|---|---|
list_workspaces |
List workspaces in a container |
get_workspace |
Get workspace details |
get_workspace_status |
Check for conflicts and modified entities |
create_workspace |
Create a new workspace |
Tags
| Tool | Description |
|---|---|
list_tags |
List all tags |
get_tag |
Get tag details |
create_tag |
Create a new tag |
update_tag |
Update a tag |
delete_tag |
Delete a tag |
Triggers
| Tool | Description |
|---|---|
list_triggers |
List all triggers |
get_trigger |
Get trigger details |
create_trigger |
Create a new trigger |
update_trigger |
Update a trigger |
delete_trigger |
Delete a trigger |
Variables
| Tool | Description |
|---|---|
list_variables |
List all variables |
get_variable |
Get variable details |
create_variable |
Create a new variable |
update_variable |
Update a variable |
delete_variable |
Delete a variable |
Built-in Variables
| Tool | Description |
|---|---|
list_built_in_variables |
List all enabled built-in variables |
Versions
| Tool | Description |
|---|---|
list_version_headers |
List all version headers (summary) |
get_live_version |
Get the published version with all entities (great for audits) |
get_version |
Get a specific version by ID |
Use Cases
- Consent Mode Audits — Analyze all tags and their consent settings in seconds
- Bulk Tag Management — Create, update, or delete tags/triggers/variables programmatically
- GDPR Compliance — Verify consent configurations across all tags
- Container Migrations — Read and replicate configurations across containers
- Documentation — Auto-generate reports of your GTM setup
About Growthers.io
Growthers.io is a data-driven growth agency specializing in analytics, tracking infrastructure, and marketing automation. We build tools that make digital marketing more efficient and compliant.
License
Apache-2.0