Zabbix MCP server

Zabbix MCP Server

<!-- mcp-name: io.github.mhajder/zabbix-mcp -->

Zabbix MCP Server is a Python-based Model Context Protocol (MCP) server designed to provide advanced, programmable access to Zabbix monitoring data and management features. It exposes a modern API for querying, automating, and integrating Zabbix resources such as hosts, templates, triggers, items, problems, events, users, proxies, maintenance periods, and more. The server supports both read and write operations, robust security features, and is suitable for integration with AI assistants, automation tools, dashboards, and custom monitoring workflows.

Features

Core Features

• Query Zabbix hosts, templates, items, triggers, and host groups with flexible filtering
• Retrieve problems, events, and alerts with severity filtering
• Access history and trend data for monitored items
• Monitor trigger states and problem severity
• Manage maintenance periods and scheduled downtimes
• Retrieve user macros and configuration data
• Get SLA and service information

Management Operations

• Create, update, and delete hosts, templates, and host groups (if enabled)
• Manage triggers, items, and discovery rules
• Configure maintenance periods and user macros
• Execute scripts on monitored hosts
• Acknowledge events and close problems
• Create and manage users and proxies
• Support for bulk operations on hosts and templates

Advanced Capabilities

• Rate limiting and API security features
• Read-only mode to restrict all write operations for safe monitoring
• Optional tool-search transform for large tool catalogs
• Bearer token authentication for HTTP transport
• Comprehensive logging and audit trails
• SSL/TLS support and configurable timeouts
• Multiple transport options (STDIO, SSE, HTTP)
• Optional Sentry integration for error tracking

Installation

Prerequisites

the zabbix-utils client accepts, and it refuses to connect outside it unless ZABBIXSKIPVERSION_CHECK=true is set

• Python 3.11 to 3.14
• Access to a Zabbix server. Versions 6.0 to 7.4 are supported - that is the range

• Valid Zabbix API token or user credentials with appropriate permissions

Quick Install from PyPI

The easiest way to get started is to install from PyPI:

# Using UV (recommended)
uvx zabbix-mcp

# Or using pip
pip install zabbix-mcp

Remember to configure the environment variables for your Zabbix instance before running the server:

# Create environment configuration
export ZABBIX_URL=https://zabbix.example.com/api_jsonrpc.php
export ZABBIX_TOKEN=your-zabbix-api-token

Install from Source

1. Clone the repository:

git clone https://github.com/mhajder/zabbix-mcp.git
cd zabbix-mcp

1. Install dependencies:

# Using UV (recommended)
uv sync

# Or using pip
pip install -e .

1. Configure environment variables:

cp .env.example .env
# Edit .env with your Zabbix URL and credentials

1. Run the server:

# Using UV (recommended)
uv run zabbix-mcp

# Or using the installed command directly
zabbix-mcp

Using Docker

Docker images are available on GitHub Packages for easy deployment.

# Normal STDIO image
docker pull ghcr.io/mhajder/zabbix-mcp:latest

# MCPO image for usage with Open WebUI
docker pull ghcr.io/mhajder/zabbix-mcpo:latest

Development Setup

For development with additional tools:

# Clone and install with development dependencies
git clone https://github.com/mhajder/zabbix-mcp.git
cd zabbix-mcp
uv sync --group dev

# Run tests
uv run pytest

# Run with coverage
uv run pytest --cov=src/

# Run linting and formatting
uv run ruff check .
uv run ruff format .

# Run type checking
uv run ty check .

# Setup prek hooks
uv run prek install

Configuration

Environment Variables

# Zabbix Connection Details
ZABBIX_URL=https://zabbix.example.com/api_jsonrpc.php

# Authentication - use EITHER token OR user/password

Shortened. The full README is on GitHub.