Google Tag Manager (GTM) MCP Server

Google Tag Manager MCP server with OAuth authentication. Connects Claude.ai and other MCP clients directly to your GTM containers and tags via Google login — no server-side OAuth credentials required.

Built with Python FastMCP using RemoteAuthProvider, following the same zero-credential architecture as the GA4 and Google Search Console MCP servers.

How it works

The server uses FastMCP's RemoteAuthProvider which advertises Google as the authorization server. When you click Connect in Claude.ai, Claude handles the Google OAuth flow itself and passes the bearer token to the server. The server validates the token via Google's tokeninfo endpoint — no Google client secrets or keys needed on the server side.

Tools

• list_accounts — Lists all GTM accounts you have access to
• list_containers — Lists all containers within a specific GTM account
• list_workspaces — Lists active workspaces in a container
• list_tags — Displays all configured tags in a workspace
• list_triggers — Displays all triggers (pageviews, clicks, custom events) in a workspace
• list_variables — Lists all user-defined and built-in variables

Deployment on Coolify

1. Connect Repository in Coolify

Point Coolify at this public repository (https://github.com/sidiio/mcp-gtm). Set Build Pack to Dockerfile.

2. Set Environment Variables

In your application environment settings, add:

Variable	Value
PORT	8080
MCP_BASE_URL	https://mcpgtm.tophathome.ca

No Google client secrets or OAuth keys required in Coolify.

3. Connect in Claude.ai

1. Open Claude.ai → Settings → Connectors (Integrations)
2. Click Add custom integration
3. URL: https://mcpgtm.tophathome.ca
4. Click Connect → Google login pop-up appears → sign in with your account → done!

Local Development

pip install -e .
MCP_BASE_URL=http://localhost:8080 python -m gtm_mcp