mcp-google-tagmanager

Google Tag Manager MCP

English | Русский

A1 Google Tag Manager MCP lets an AI app inspect and manage Google Tag Manager containers in plain language. See what fires on a page, work with tags, triggers and variables in a draft workspace, then deliberately compile and publish a version when you are ready.

It connects to the Google Tag Manager API v2 through your Google account. The difference from asking an AI to guess a GTM setup is that it works with the actual container, workspace and version you choose.

• 19 tools. 10 operations only read GTM data; 4 create drafts or change built-in variables; 5 can alter, delete, compile or publish live configuration.
• Draft first. Tags, triggers and variables are created in a workspace. Publishing is a separate, explicitly destructive operation.
• Quota-aware. GTM permits 0.25 requests per second per project; the server spaces requests by at least 4.2 seconds instead of overwhelming the API.
• Your Google access. The server uses your OAuth credentials and requests only the Tag Manager scopes needed for reading, editing, versioning and publishing.

Start with a read-only question:

Which tags in my containers fire on the page-view trigger?

Connect the server · Explore use cases · Open technical documentation

See it work in a minute

You: List my GTM containers and show which tags fire on page view.

Assistant: Lists the containers, their workspaces, relevant triggers and the tags attached to them. Nothing changes.

You: In the Default Workspace of GTM-ABC123, prepare a GA4 configuration tag for measurement ID G-XXXXXXX on all pages.

Assistant: Shows the workspace, proposed tag and trigger configuration, then asks for confirmation before creating the draft.

You: Confirm the draft.

Assistant: Creates the tag in the workspace. It does not publish the container; compiling and publishing a version remains a separate step.

Contents

• Quick start
• What you can ask it to do
• How GTM changes are connected
• What can change
• Getting access
• Configuration
• Data and telemetry
• Limits and background work
• Technical documentation
• Support

Quick start

You need Node.js 20+, a Google account with access to a GTM container and OAuth credentials from a Google Cloud project where the Tag Manager API is enabled.

• Prepare Google OAuth access.
• Add the server to your AI app.
• Start with the read-only question above.

Codex

In the app:

• Open Settings → Plugins → MCP servers.
• Select Add server.
• Add npx -y mcp-google-tagmanager@latest and the three environment variables below.

Variable	Value
GOOGLE_TAGMANAGER_CLIENT_ID	Your Google OAuth client ID
GOOGLE_TAGMANAGER_CLIENT_SECRET	Your Google OAuth client secret
GOOGLE_TAGMANAGER_REFRESH_TOKEN	Your Google OAuth refresh token

From the command line:

codex mcp add google-tagmanager \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-tagmanager@latest

codex mcp list

Codex MCP documentation

Claude Code

claude mcp add \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  --transport stdio \
  --scope user \
  google-tagmanager \
  -- npx -y mcp-google-tagmanager@latest

claude mcp list

Claude Code MCP documentation

Claude Desktop

• Open Settings → Developer → Edit Config.
• Add this entry to mcpServers:

{
  "mcpServers": {
    "google-tagmanager": {
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

If Edit Config is unavailable, edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows.

Claude Desktop MCP documentation

Cursor

Add a user-level server to ~/.cursor/mcp.json on macOS/Linux or %USERPROFILE%\.cursor\mcp.json on Windows:

{
  "mcpServers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Cursor MCP documentation

VS Code

Run MCP: Open User Configuration from the Command Palette and add:

{
  "servers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "${input:gtm_client_id}",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "${input:gtm_client_secret}",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "${input:gtm_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "gtm_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "gtm_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "gtm_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

Check it with MCP: List Servers.

VS Code MCP documentation

What you can ask it to do

Understand the current setup

• List the GTM accounts and containers I can access.
• Which tags fire on page view in this workspace?
• Show the trigger and variable configuration for this tag.
• Which built-in variables are enabled?

Prepare tracking changes in a draft

• Create a workspace for the checkout tracking change.
• Prepare a GA4 tag and a trigger for a specific event.
• Enable the click variables needed for this trigger.
• Update this tag after showing me the complete replacement configuration.

Release a version deliberately

• Compile this workspace into a version named April release.
• Show the compiler errors, if any.
• Publish version 42 after I confirm the version and its changes.

How GTM changes are connected

GTM has a clear release path:

• An account contains one or more containers.
• A container has workspaces for draft changes.
• Tags, triggers and variables belong to a workspace.
• Compiling a workspace creates a container version and removes the source workspace. GTM provides a replacement workspace.
• Publishing makes a selected container version live.

This server can inspect each step. It does not treat a draft as a release: version creation and publishing are separate operations.

What can change

Operation	What happens	Confirmation boundary
List accounts, containers, workspaces, tags, triggers, variables and versions	Reads GTM configuration	No change
Create a container or workspace	Adds a new GTM object	Changes GTM
Create a tag, trigger or variable	Adds a draft object to a workspace	Changes a draft workspace
Enable or disable built-in variables	Changes the workspace configuration	Changes a draft workspace
Update a tag, trigger or variable	Replaces the complete resource, protected by its fingerprint	Potentially destructive
Delete a tag, trigger or variable	Removes the selected object	Destructive
Compile a workspace	Creates a version and deletes the source workspace	Destructive
Publish a version	Makes a selected version live	Destructive
Raw API request	Can call API methods without a dedicated tool	Potentially destructive

The AI client decides how it asks for confirmation. The server marks read-only, write and destructive operations so the client can distinguish inspection from a real change.

Getting access

The server uses Google OAuth 2.0. Google Tag Manager does not provide API keys for this user data.

• Create or select a Google Cloud project and enable the Tag Manager API. A project without that API enabled receives no quota.

• Configure the OAuth consent screen and create an OAuth client. A Desktop app client is suitable for local use.

• Authorize your Google account and obtain a refresh token. The OAuth 2.0 Playground can do this if you enable Use your own OAuth credentials.

• Request these scopes together:

  https://www.googleapis.com/auth/tagmanager.readonly
  https://www.googleapis.com/auth/tagmanager.edit.containers
  https://www.googleapis.com/auth/tagmanager.edit.containerversions
  https://www.googleapis.com/auth/tagmanager.publish
  

The scopes are separate: reading, editing, compiling versions and publishing each need their corresponding permission. Treat the client secret and refresh token as passwords.

Configuration

Variable	Required	Description
GOOGLE_TAGMANAGER_CLIENT_ID	Yes*	OAuth client ID.
GOOGLE_TAGMANAGER_CLIENT_SECRET	Yes*	OAuth client secret.
GOOGLE_TAGMANAGER_REFRESH_TOKEN	Yes*	OAuth refresh token.
GOOGLE_TAGMANAGER_ACCESS_TOKEN	Yes*	Short-lived alternative to the OAuth trio.
GOOGLE_TAGMANAGER_API_BASE	No	Tag Manager API base URL override.
GOOGLE_TAGMANAGER_TIMEOUT_MS	No	Per-request timeout; default 60000 ms.
GOOGLE_TAGMANAGER_MAX_RETRIES	No	Maximum retries on temporary failures; default 3.
GOOGLE_TAGMANAGER_MIN_INTERVAL_MS	No	Minimum request spacing; default 4200 ms.

* Provide either the OAuth trio or an access token. Access tokens expire in about an hour and are not refreshed automatically.

Data and telemetry

The server runs locally and sends GTM API requests and OAuth refresh requests to Google. Its anonymous telemetry contains a random installation ID, package version, AI client and Node.js/operating-system versions, and tool names. It does not send OAuth tokens, GTM data, tool arguments or prompts.

Disable telemetry for A1 MCP servers with:

ASKADS_TELEMETRY=0

Limits and background work

• GTM is rate-limited. The API allows 0.25 requests per second per project, so the server serializes calls at least 4.2 seconds apart. Broad audits can therefore take time.
• Temporary limits are retried carefully. 429 and Google quota 403 responses use exponential backoff and Retry-After. Reads retry after network and 5xx failures; writes are not replayed after an uncertain failure.
• There is no background monitoring. The server runs only when your AI app calls it. If the app supports scheduled tasks, it can periodically inspect a container or its live version.
• A workspace disappears when compiled. Before calling create_version, save anything you need from the workspace and inspect the returned replacement workspace path.

Technical documentation

• MCP capability catalog — task-oriented pages for every tool.
• All tools and inputs
• Development documentation
• Publishing documentation
• Google Tag Manager API v2 reference

Support

Found a bug or need a scenario? Create an issue or write in Telegram.

You made it to the end!