Gatescrispy/mcp-gtm-ultimate

MCP GTM Ultimate

The most comprehensive local Google Tag Manager MCP server for advanced tag management and automation.

🎯 Overview

MCP GTM Ultimate is a powerful Model Context Protocol server that provides complete Google Tag Manager API v2 integration. Built for developers, marketers, and analysts who need programmatic control over their GTM containers, tags, triggers, and variables.

✨ Key Features

• 🔧 Complete GTM Management: 70+ tools covering all GTM API v2 functionalities
• 🏷️ Smart Tag Operations: Create, update, delete tags with intelligent defaults
• ⚡ Trigger Management: Full CRUD operations on GTM triggers
• 📊 Variable Control: Manage custom and built-in variables
• 📦 Version Control: Handle container versions and publishing
• 👥 User Permissions: Manage team access and permissions
• 🛡️ Intelligent Error Handling: Categorized error responses with smart fallbacks
• 🔍 Real-time Monitoring: Live GTM container state inspection

🚀 Quick Start

Prerequisites

• Python 3.8+
• Google Cloud Project with Tag Manager API enabled
• Service Account with appropriate GTM permissions

Installation

pip install mcp-gtm-ultimate

Configuration

1. Enable Google Tag Manager API in your Google Cloud Console
2. Create a Service Account with GTM permissions
3. Download the service account JSON key
4. Set environment variables:

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account.json"
export GTM_ACCOUNT_ID="your-gtm-account-id"
export GTM_CONTAINER_ID="your-gtm-container-id"

Basic Usage

from mcp_gtm_ultimate import MCPGTMUltimate

# Initialize the MCP server
gtm = MCPGTMUltimate()

# Authenticate
gtm.authenticate()

# List all tags
tags = gtm.list_tags()

# Create a new tag
new_tag = gtm.create_tag_smart(
    name="Analytics Event",
    tag_type="gaawe",
    parameters=[{
        "type": "template",
        "key": "measurementIdOverride", 
        "value": "G-XXXXXXXXXX"
    }]
)

# List all containers
containers = gtm.list_containers()

📊 Comparison with Existing Solutions

🛠️ Core Functionalities

Phase 1: Core Management (15 tools)

• Accounts: List, get, update account information
• Containers: Complete container lifecycle management
• Workspaces: Workspace creation and management

Phase 2: Content Management (22 tools)

• Tags: Create, read, update, delete, revert tags
• Triggers: Full trigger management with conditions
• Variables: Custom and built-in variable control
• Built-in Variables: Enable/disable system variables

Phase 3: Organization & Publishing (22 tools)

• Versions: Version control and publishing pipeline
• Folders: Organize tags and triggers in folders
• Zones: Zone-based tag management (Enterprise)

Phase 4: Advanced Features (11 tools)

• Templates: Custom template creation and management
• User Permissions: Team access control
• Advanced Publishing: Staged rollouts and rollbacks

🔧 Configuration Example

{
  "mcpServers": {
    "gtm-ultimate": {
      "command": "python",
      "args": ["-m", "mcp_gtm_ultimate"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
        "GTM_ACCOUNT_ID": "your-account-id",
        "GTM_CONTAINER_ID": "your-container-id",
        "GTM_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

🧪 Testing

Test Results: 80% success rate on real GTM infrastructure

• ✅ Core Management: 100% (5/5)
• ✅ Content Management: 100% (2/2)
• ✅ Error Handling: 100% (2/2)
• 🟡 Advanced Features: Limited by API permissions

🌟 Why Choose MCP GTM Ultimate?

🏆 Most Comprehensive

• 70+ tools vs 15 in competitors
• Complete API v2 coverage including enterprise features
• Real-world tested on production GTM containers

🔒 Privacy-First

• 100% local execution - your data never leaves your infrastructure
• No external dependencies on third-party services
• Full control over your GTM operations

🚀 Production Ready

• Intelligent error handling with categorized responses
• Robust authentication with Google Cloud integration
• Comprehensive logging and monitoring capabilities

🛠️ Developer Friendly

• Clear documentation with examples
• Type hints throughout the codebase
• Extensible architecture for custom requirements

📖 Documentation

🤝 Contributing

We welcome contributions! Please see our for details.

📄 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

• Model Context Protocol for the MCP specification
• Google Tag Manager API for the comprehensive API
• The open-source community for inspiration and feedback

MCP GTM Ultimate - Empowering advanced Google Tag Manager automation 🚀