Summary

Checkmk monitoring: hosts and their configuration, live service states, acknowledged and unhandled problems, host groups and downtimes. REST API on your own site, bearer-style automation user auth.

Guided setup

Connect Checkmk to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Checkmk in the guided setup, then add your MCP URL to Gemini. No code and no server to run.

Set up Checkmk free I already have an account

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Checkmk

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Checkmk · live via MCP

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Checkmk, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Checkmk + Gemini

Checkmk monitoring: hosts and their configuration, live service states, acknowledged and unhandled problems, host groups and downtimes. REST API on your own site, bearer-style automation user auth.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

CHECKMK_URL, CHECKMK_USERNAME, CHECKMK_SECRET

Step 1 — Get credentials

Setup

In Checkmk create an automation user: Setup → Users → Add user, tick Automation secret for machine accounts, and copy the secret. Give it the guest role for read-only access, or admin if you want the configuration endpoints.
Set CHECKMK_URL to your site root including the site name — https://monitoring.example.com/mysite — with no trailing slash. The site name is part of the path and leaving it out is the usual cause of a 404 that looks like a wrong version.
Set CHECKMK_USERNAME to the automation user and CHECKMK_SECRET to its secret.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
Save the file and restart gemini.
Run /mcp inside the Gemini CLI — Checkmk should be listed as available.
Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID to the tools array of your request with the same X-API-Key header.

Available tools

Tool	What it does
`checkmk_get_version`	Read the Checkmk version and edition of this site
`checkmk_list_hosts`	List hosts from the configuration: what has been set up for monitoring, with folder, attributes and effective settings
`checkmk_get_host_config`	Read one host's configuration: its folder, IP address, tags, labels and the attributes it inherits
`checkmk_list_host_states`	Read the live state of hosts: up, down or unreachable, with the check output and how long each has been that way
`checkmk_list_service_states`	Read the live state of services — the red, amber and green checks
`checkmk_list_host_services`	Read every service on one host with its current state and check output — the drill-down after a host has been flagged
`checkmk_list_host_groups`	List the host groups configured on this site with their alias, so a query can be scoped to a part of the estate
`checkmk_list_downtimes`	List scheduled downtimes with their host, service, comment, author and window — the explanation for why an alert did not fire
`checkmk_list_folders`	List the Checkmk folder tree with each folder's title, path and attributes — how hosts are organised and where settings are inherited from

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.

Next steps

Was this guide helpful?

Connect Checkmk to Gemini CLI via MCP

Connect Checkmk to Gemini in 2 minutes

Example prompts for Checkmk

Checkmk + Gemini

Prerequisites

Step 1 — Get credentials

Step 2 — Install the adapter

Step 3 — Add the connector in Gemini

Available tools

FAQ

Next steps

Connect Checkmk to Gemini in 2 minutes

Related guides

Connect Checkmk to Microsoft Copilot via MCP

Connect Checkmk to Meta Muse via MCP

Checkmk MCP Server: Hosts, Services and Downtimes

Connect Checkmk to ChatGPT via MCP

Connect Checkmk to Claude via MCP

Connect Checkmk to Cursor via MCP