paolobietolini/gtm-mcp-server

---
> [!IMPORTANT]
> The hosted instance at https://mcp.gtmeditor.com will be shut down on November 30, 2026. See #139 for details. Thanks to everyone who used it!
---
GTM MCP Server connects MCP clients to the Google Tag Manager API. It can
inspect containers, create and update workspace entities, create versions, and
publish a selected version after explicit confirmation.
Use the hosted server at:
The server supports browser-based Google OAuth for individual users and
service-account authentication for self-hosted automation.
Project status
| Item | Current state |
|---|---|
| Version in server.json | 1.12.3 |
| Transport | MCP Streamable HTTP |
| Runtime tools | 64 GTM tools by default; 94 with GTM_TOOL_GROUPS=all, plus 2 utility tools |
| MCP resources | 8 resource definitions |
| MCP prompts | 6 prompts |
| Official GTM API coverage | 101 of 106 methods |
| Hosted endpoint | https://mcp.gtmeditor.com |
The project implements 101 methods from Google's 106-method GTM v2 discovery surface. The five accounts.user_permissions methods are intentionally excluded because granting and revoking GTM access are security-related and it shouldn't be manager by an LLM.
Connect an MCP client
Add the hosted URL as a remote HTTP MCP server. The client should discover the OAuth metadata, open Google sign-in, and reconnect with the issued bearer
token.
Claude Code
Gemini CLI
Gemini CLI can also use this settings.json entry:
Cursor
Add the following to .cursor/mcp.json:
ChatGPT, Codex, and Claude web
Add a custom or remote MCP connection in the client and use
https://mcp.gtmeditor.com as the server URL. Product menus change more often
than this server, so refer to the client's current MCP connection instructions
if the label differs.
After connecting, try:
The Google account used during OAuth determines which GTM accounts the server
can access.
Typical workflow
1. Call list_accounts, list_containers, and list_workspaces to discover
IDs. Do not guess IDs.
2. Inspect the workspace with list/get tools or the audit_container prompt.
3. Create or update tags, triggers, variables, templates, clients, or
transformations in the selected workspace.
4. Call get_workspace_status and resolve conflicts before versioning.
5. Call create_version to snapshot the workspace.
6. Inspect the saved version with get_version.
7. Call publish_version with confirm: true only when the selected version
is ready to go live.
8. Verify the published state with get_live_version.
Example requests:
- "Audit this workspace for duplicate tags and unused triggers."
- "Create a GA4 purchase event tag, but do not publish it."
- "Show the difference between the latest saved version and the live version."
- "Generate a Markdown tracking plan from this workspace."
- "Import the iubenda template from the Community Template Gallery."
Tools
All GTM tools use the authenticated Google identity from the current MCP
request. Inputs and outputs are structured JSON.
Utility
| Tool | Purpose |
|---|---|
| ping | Test MCP connectivity |
| auth_status | Check whether the current request is authenticated |
Accounts and containers
| Tool | Purpose |
|---|---|
| list_accounts | List accessible GTM accounts |
| update_account | Rename an account |
| list_containers | List containers and their public IDs and settings |
| lookup_container | Find a container by destination ID or GTM public tag ID |
| get_container_snippet | Get a web install snippet or server-container configuration |
| create_container | Create a web, app, AMP, or server container |
| update_container | Rename a container while preserving its other settings |
| delete_container | Permanently delete a container; requires confirm: true |
| combine_containers | Merge a source container into a target; requires confirm: true |
| move_tag_id | Move a tag ID into a new container; requires confirmation and terms acceptance |
Workspaces
| Tool | Purpose |
|---|---|
| list_workspaces | List workspaces in a container |
| create_workspace | Create a workspace |
| get_workspace | Get workspace metadata and its current fingerprint |
| update_workspace | Update selected workspace fields |
| delete_workspace | Delete a workspace; requires confirm: true |
| quick_preview_workspace | Compile an ephemeral preview without saving or publishing |
| get_workspace_status | Show pending changes and merge conflicts |
| bulk_update_workspace | Apply multiple entity changes; requires confirm: true |