Zabbix MCP Server

<div align="center"> <a href="http://www.initmax.com"><img src="./.readme/logo/initMAX_banner.png" alt="initMAX Logo"></a> <h3> <span> Honesty, diligence and MAXimum knowledge of our products is our standard. </span> </h3> <h3> <a href="https://www.initmax.com/"> <img alt="Static Badge" src="https://img.shields.io/badge/initMAX.com-%20?color=%231f65f4&logo=data:image/png;base64,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"> </a>&nbsp; <a href="https://www.linkedin.com/company/initmax/"> <img alt="LinkedIn" src="https://img.shields.io/badge/%20-%20?style=social&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHJvbGU9ImltZyIgdmlld0JveD0iMCAwIDI0IDI0Ij4KICA8dGl0bGU+TGlua2VkSW48L3RpdGxlPgogIDxwYXRoIGZpbGw9IiMwQTY2QzIiIGQ9Ik0yMC40NDcgMjAuNDUyaC0zLjU1NHYtNS41NjljMC0xLjMyOC0uMDI3LTMuMDM3LTEuODUyLTMuMDM3LTEuODUzIDAtMi4xMzYgMS40NDUtMi4xMzYgMi45Mzl2NS42NjdIOS4zNTFWOWgzLjQxNXYxLjU2MWguMDQ5Yy40NzYtLjkgMS42MzctMS44NTIgMy4zNjgtMS44NTIgMy41OTkgMCA0LjI2NyAyLjM2OSA0LjI2NyA1LjQ1NXY2LjI4OHpNNS4zMzcgNy40MzNjLTEuMTQ0IDAtMi4wNjktLjkyNi0yLjA2OS0yLjA2OCAwLTEuMTQzLjkyNS0yLjA2OSAyLjA2OS0yLjA2OSAxLjE0MiAwIDIuMDY4LjkyNiAyLjA2OCAyLjA2OSAwIDEuMTQyLS45MjYgMi4wNjgtMi4wNjggMi4wNjh6bTEuNzc3IDEzLjAxOUgzLjU2VjloMy41NTR2MTEuNDUyek0yMi4yMjUgMEgxLjc3MUMuNzkyIDAgMCAuNzc0IDAgMS43Mjl2MjAuNTQyQzAgMjMuMjI3Ljc5MiAyNCAxLjc3MSAyNGgyMC40NTFDMjMuMiAyNCAyNCAyMy4yMjcgMjQgMjIuMjcxVjEuNzI5QzI0IC43NzQgMjMuMiAwIDIyLjIyMiAwaC4wMDN6Ii8+Cjwvc3ZnPgo="> </a>&nbsp; <a href="https://www.youtube.com/@initmax1"> <img alt="Static Badge" src="https://img.shields.io/badge/%20-web?style=social&logo=youtube"> </a>&nbsp; <a href="https://www.facebook.com/initmax"> <img alt="Static Badge" src="https://img.shields.io/badge/%20-%20?style=social&logo=facebook"> </a>&nbsp; <a href="https://www.instagram.com/initmax/"> <img alt="Static Badge" src="https://img.shields.io/badge/%20-%20?style=social&logo=instagram"> </a>&nbsp; <a href="https://twitter.com/initmax"> <img alt="Static Badge" src="https://img.shields.io/badge/%20-%20?style=social&logo=x"> </a>&nbsp; <a href="https://github.com/initmax"> <img alt="Static Badge" src="https://img.shields.io/badge/%20-%20?style=social&logo=github"> </a> </h3> <h3> <a><img src="./.readme/logo/zabbix-premium-partner.png" alt="Zabbix premium partner" width="100"></a>&nbsp;&nbsp;&nbsp; <a><img src="./.readme/logo/zabbix-certified-trainer.png" alt="Zabbix certified trainer" width="100"></a> </h3> </div> <br> <br>

---

---

<div align="center"> <h1> Zabbix MCP Server </h1> <h4> Complete Zabbix API coverage for any MCP-compatible AI assistant (225 tools) </h4> <br> <a href="https://github.com/initMAX/zabbix-mcp-server/releases"><img alt="Version" src="https://img.shields.io/github/v/release/initMAX/zabbix-mcp-server?color=%231f65f4&label=version"></a>&nbsp; <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-AGPL--3.0-blue"></a>&nbsp; <img alt="Python" src="https://img.shields.io/badge/python-3.10%2B-blue">&nbsp; <img alt="Tools" src="https://img.shields.io/badge/tools-225-green">&nbsp; <img alt="Zabbix" src="https://img.shields.io/badge/zabbix-5.0%E2%80%948.0-red">&nbsp; <a href="https://safeskill.dev/scan/initmax-zabbix-mcp-server"><img alt="SafeSkill" src="https://img.shields.io/badge/SafeSkill-100%2F100_Verified%20Safe-brightgreen"></a> </div> <br> <br>

What is this?

MCP (Model Context Protocol) is an open standard that lets AI assistants (ChatGPT, Claude, VS Code Copilot, JetBrains AI, Codex, and others) use external tools. This server exposes the entire Zabbix API as MCP tools — allowing any compatible AI assistant to query hosts, check problems, manage templates, acknowledge events, and perform any other Zabbix operation.

The server runs as a standalone HTTP service. AI clients connect to it over the network.

Features

• Complete API coverage - All 58 Zabbix API groups (225 tools): hosts, problems, triggers, templates, users, dashboards, and more
• Multi-server support - Connect to multiple Zabbix instances (production, staging, ...) with separate tokens
• HTTP + SSE transports - Streamable HTTP (recommended) and SSE for clients like n8n that lack session management
• Tool filtering - Limit exposed tools by category (monitoring, alerts, users, etc.) to stay under LLM tool limits
• Compact output mode - Get methods return only key fields by default, reducing token usage; LLM can request extend for full details
• LLM-friendly normalizations - Symbolic enum names, auto-fill defaults, preprocessing cleanup, timestamp conversion
• Single config file - One TOML file, no scattered environment variables
• Read-only mode - Per-server write protection to prevent accidental changes
• Rate limiting - Per-client call budget (300/min default) to protect Zabbix from flooding
• Auto-reconnect - Transparent re-authentication on session expiry
• Production-ready - systemd service, logrotate, security hardening
• Generic fallback - zabbix_raw_api_call tool for any API method not explicitly defined

Quick Start

git clone https://github.com/initMAX/zabbix-mcp-server.git
cd zabbix-mcp-server
sudo ./deploy/install.sh
sudo nano /etc/zabbix-mcp/config.toml   # fill in your Zabbix URL + API token
sudo systemctl start zabbix-mcp-server
sudo systemctl enable zabbix-mcp-server

Done. The server is running on http://127.0.0.1:8080/mcp.

Installation

Detailed guide: See INSTALL.md for step-by-step instructions for both on-prem (systemd) and Docker deployments, including uninstall, security checklist, and TLS setup.

Requirements

• Linux server with Python 3.10+
• Network access to your Zabbix server(s)
• Zabbix API token (User settings > API tokens)

Install

git clone https://github.com/initMAX/zabbix-mcp-server.git
cd zabbix-mcp-server
sudo ./deploy/install.sh

The install script will:

1. Create a dedicated system user zabbix-mcp (no login shell)
2. Create a Python virtual environment in /opt/zabbix-mcp/venv
3. Install the server and all dependencies
4. Copy the example config to /etc/zabbix-mcp/config.toml
5. Install a systemd service unit (zabbix-mcp-server)
6. Set up logrotate for /var/log/zabbix-mcp/*.log (daily, 30 days retention)
7. Verify file permissions and offer to fix any issues

Upgrade

cd zabbix-mcp-server
git fetch origin && git reset --hard origin/main
sudo ./deploy/install.sh update

The git fetch + reset ensures a clean sync with upstream regardless of local state or history rewrites. The update command will then upgrade the package, refresh the systemd unit and logrotate config, check file permissions (and offer to fix any issues), and restart the service if it is running.

Note: From v1.15+, sudo ./deploy/install.sh update handles git sync automatically — the explicit git fetch + reset is only needed when upgrading from older versions.

Configure

Edit the config file with your Zabbix server details:

sudo nano /etc/zabbix-mcp/config.toml

Minimal configuration - just fill in your Zabbix URL and API token:

[server]
transport = "http"
host = "127.0.0.1"
port = 8080

[zabbix.production]
url = "https://zabbix.e