mpeirone/zabbix-mcp-server

A lightweight Model Context Protocol (MCP) server that provides **complete access to the entire Zabbix API** through just 3 tools. Compatible with **Zabbix 6.0+**.
Why Zabbix MCP Server?
- **Complete API Coverage** - Access every Zabbix API method (100+) through a unified interface
- **Lightweight Context** - Only 3 tools instead of 50+ individual tools, keeping LLM context minimal
- **Always Up-to-Date** - Works with current and future Zabbix API methods automatically
- **Zabbix 6.0+ Compatible** - Supports Zabbix 6.0, 6.4, 7.0, and newer versions
The 3 Tools
| Tool | Purpose |
|------|---------|
| zabbix_api | Execute any Zabbix API method |
| zabbix_api_docs | Get documentation for any API method |
| zabbix_api_list | Discover available API objects and methods |
Quick Start
Option 1: Claude Code Integration
Add to your Claude Code MCP configuration:
Option 2: Run with uv
Test Connection
Option 3: Run with docker
Environment Variables
Required
| Variable | Description | Example |
|----------|-------------|---------|
| ZABBIX_URL | Zabbix server URL | https://your-zabbix-server.com |
Authentication (choose one)
| Variable | Description |
|----------|-------------|
| ZABBIX_TOKEN | API token (recommended) |
| ZABBIX_USER + ZABBIX_PASSWORD | Username and password |
Security
| Variable | Default | Description |
|----------|---------|-------------|
| READ_ONLY | false | Set to true to allow only read operations |
| VERIFY_SSL | true | Enable/disable SSL verification |
| ZABBIX_API_WHITELIST | .* | Comma-separated regex patterns for allowed API methods |
| ZABBIX_API_BLACKLIST | (empty) | Comma-separated regex patterns for blocked API methods |
| ZABBIX_SKIP_VERSION_CHECK | false | Skip Zabbix version compatibility check |
| ZABBIX_API_TIMEOUT | 30 | API request timeout in seconds |
Transport
| Variable | Default | Description |
|----------|---------|-------------|
| ZABBIX_MCP_TRANSPORT | stdio | Transport type: stdio or streamable-http |
| ZABBIX_MCP_HOST | 127.0.0.1 | HTTP server host (when using streamable-http) |
| ZABBIX_MCP_PORT | 8000 | HTTP server port (when using streamable-http)|
| ZABBIX_MCP_STATELESS_HTTP | false | Stateless HTTP mode |
| AUTH_TYPE | - | Must be no-auth for HTTP transport (when using streamable-http) |
Debug
| Variable | Default | Description |
|----------|---------|-------------|
| DEBUG | false | Set to true for verbose logging |
Usage Examples
Get Hosts
Get Problems
Create Host
Get Method Documentation
List Available Methods
Security Features
Read-Only Mode
Set READ_ONLY=true to block all write operations:
Only get, version, check, and export operations will be allowed.
API Method Filtering
Control which API methods can be called using whitelist/blacklist patterns:
Both support comma-separated regex patterns. Blacklist is checked first.