KOVA MCP

Talk to your myGEKKO in your words. An open-source MCP server that connects Claude (and any other MCP client) to myGEKKO building controllers — via the official myGEKKO Query API. Talk to your myGEKKO building controller from Claude — English quickstart below.

„Wie warm ist es im Wohnzimmer?" · „Welche Lichter sind noch an?" · „Mach die Rollläden im Süden runter." — in your own words, straight to your house.

KOVA MCP is the tool for tinkerers and power users. If you want it daily, on your phone, and for the whole family — without a terminal: that is what the KOVA App is for (kova.casa).

Try it in 2 minutes — without your own controller

The public myGEKKO demo controller (“Mustermann”) is there for exactly this kind of test:

claude mcp add mygekko \
  --env GEKKO_USERNAME=mustermann@my-gekko.com \
  --env GEKKO_KEY=HjR9j4BrruA8wZiBeiWXnD \
  --env GEKKO_GEKKOID=K999-7UOZ-8ZYZ-6TH3 \
  -- uvx --from git+https://github.com/joeexafionbot-dev/kova-mcp mygekko-mcp

Then in Claude Code: “What systems does my building have? Show me the lights in the living room.”

Related MCP server: Homey MCP Server

With your own myGEKKO

Prerequisite: controller registered on my-gekko.com and the Plus service “myGEKKO Query API” activated (included in the Home Bundle; generate a key under Settings → Globe → Plus Advanced → Plus Query API → Administration → Generate new).

claude mcp add mygekko \
  --env GEKKO_USERNAME=deine@mail.de \
  --env GEKKO_KEY=DEIN-QUERY-API-KEY \
  --env GEKKO_GEKKOID=XXXX-XXXX-XXXX-XXXX \
  -- uvx --from git+https://github.com/joeexafionbot-dev/kova-mcp mygekko-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mygekko": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/joeexafionbot-dev/kova-mcp", "mygekko-mcp"],
      "env": {
        "GEKKO_USERNAME": "deine@mail.de",
        "GEKKO_KEY": "DEIN-QUERY-API-KEY",
        "GEKKO_GEKKOID": "XXXX-XXXX-XXXX-XXXX"
      }
    }
  }
}

Also possible locally (LAN instead of cloud): GEKKO_MODE=local + GEKKO_LOCAL_HOST — all variables in .env.example.

What the server supports capabilities

Security (deliberately conservative)

• Read-only by default. Control requires explicit GEKKO_ALLOW_WRITE=true.

• Deny-list always remains enforced: alarm system, doors/access, and cameras are blocked even with write access enabled; critical actions require a second confirmation.

• Credentials only via environment variables, never in files/logs (the key is redacted in logs).

• Controller-friendly: rate limits and backoff on 429/470 — otherwise faulty requests would fall into the controller's alarm log.

Details: SECURITY.md.

English quickstart

MCP server for myGEKKO building controllers (official Query API, cloud or LAN). Read-only by default; writes are opt-in (“off”) and policy-gated (alarm/access/camera are always denied). Try it instantly with the public demo controller using the credentials above, or set GEKKO_USERNAME / GEKKO_KEY / GEKKO_GEKKOID in your own controller. Run via uvx --from git+https://github.com/joeexafionbot-dev/kova-mcp mygekko-mcp.

Development

GXP4

The repository is the release mirror of the KOVA monorepo (where CI runs); issues and PRs are still welcome and will be forwarded back.

License & trademarks

MIT. myGEKKO is a trademark of myGEKKO | Ekon GmbH — KOVA MCP is an independent community project and is not released by myGEKKO. The demo credentials above belong to the public myGEKKO demo controller.