Skip to content
MCP server

Hive heating

Check Hive thermostats, radiator valves and hot water, and boost heating on request

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, macOS, Windows
Runs
Locally
Version
0.5.0
Listing updated
2 days ago

About Hive heating

Hive heating is an open-source MCP server for smart home. It runs locally on your machine and is started by your AI client.

This unofficial open-source server logs in to your own Hive account, using the same undocumented API as the Hive app and Home Assistant, and exposes 24 tools: 11 read and 11 write, in five toolsets. It reads zone temperatures, schedules, device batteries and signal, hot water, smart plugs, lights and window or door sensors.

Hive logins need a text-message code. You enter it once and the server registers itself as a remembered device, so later logins need no code; the server never starts an SMS login on its own. It is read-only unless HIVE_ALLOW_WRITES is on, targets are limited to 5-25 °C by default (HIVE_MAX_TEMP can raise it), boosts to six hours and holiday mode to 60 days. Readings are cached for 30 seconds. Five guided prompts include going_away, home_check, hot_water_now, schedule_review and warm_up. The README states it is not endorsed by Hive, British Gas or Centrica.

Install

Run in a terminal

claude mcp add hive-mcp --env HIVE_USERNAME='<HIVE_USERNAME>' --env HIVE_PASSWORD='<HIVE_PASSWORD>' -- docker run -i --rm -e HIVE_USERNAME -e HIVE_PASSWORD ghcr.io/mattoddie/hive-mcp:0.5.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hive-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HIVE_USERNAME",
        "-e",
        "HIVE_PASSWORD",
        "ghcr.io/mattoddie/hive-mcp:0.5.0"
      ],
      "env": {
        "HIVE_USERNAME": "<HIVE_USERNAME>",
        "HIVE_PASSWORD": "<HIVE_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hive-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HIVE_USERNAME",
        "-e",
        "HIVE_PASSWORD",
        "ghcr.io/mattoddie/hive-mcp:0.5.0"
      ],
      "env": {
        "HIVE_USERNAME": "<HIVE_USERNAME>",
        "HIVE_PASSWORD": "<HIVE_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "hive-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HIVE_USERNAME",
        "-e",
        "HIVE_PASSWORD",
        "ghcr.io/mattoddie/hive-mcp:0.5.0"
      ],
      "env": {
        "HIVE_USERNAME": "<HIVE_USERNAME>",
        "HIVE_PASSWORD": "<HIVE_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hive-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HIVE_USERNAME",
        "-e",
        "HIVE_PASSWORD",
        "ghcr.io/mattoddie/hive-mcp:0.5.0"
      ],
      "env": {
        "HIVE_USERNAME": "<HIVE_USERNAME>",
        "HIVE_PASSWORD": "<HIVE_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hive-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HIVE_USERNAME",
        "-e",
        "HIVE_PASSWORD",
        "ghcr.io/mattoddie/hive-mcp:0.5.0"
      ],
      "env": {
        "HIVE_USERNAME": "<HIVE_USERNAME>",
        "HIVE_PASSWORD": "<HIVE_PASSWORD>"
      }
    }
  }
}

Configuration

  • MCP_TRANSPORTServe MCP over stdio (the image defaults to HTTP).
  • HIVE_USERNAMEThe email address you log in to the Hive app with.Required
  • HIVE_PASSWORDYour Hive password, used to log in and to log in again by itself as a remembered device.Required
  • HIVE_ALLOW_LOGIN_TOOLSLet the assistant log in for you with an SMS code (hive_auth_start and hive_auth_complete).
  • HIVE_ALLOW_WRITESAllow changes to your home: heating, boosts, hot water, holiday mode, plugs and lights. Off means read-only.
  • HIVE_MAX_TEMPThe highest heating target the assistant may set, in °C: 5 to 32 in steps of 0.5.
  • HIVE_TOOLSETSOptional comma-separated toolsets to expose fewer tools, e.g. home,heating,hotwater. Empty means all but raw.
  • HIVE_AUDIT_LOGOptional audit log of every change and login: stderr, or a file on the volume such as /data/audit.jsonl.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

hive_auth_start
Starts a login that sends an SMS code.
hive_auth_complete
Completes login with the SMS code.

What it does

Heating and valves
Reads and sets heating zones and radiator valve zones, including boosts.
Hot water control
Switch hot water on, off or back to schedule, with boosts.
Device health
Lists Hive devices with battery and signal levels.
Validated changes
Rejects out-of-range temperatures, long boosts and unconfirmed indefinite settings.
Guided prompts
Five prompts cover leaving home, a home check, hot water, schedule review and warming up.

Good for

  • Ask how warm each room is
  • Boost heating for an hour
  • Switch hot water on before a bath
  • Set holiday mode while away
  • Find devices with low batteries

Pricing

Open source

MIT licence; requires a Hive account

Prices change. Check hive-mcp.mattoddie.dev before you buy.

Hive heating FAQ

Is it official?

No. It is unofficial and not made or endorsed by Hive, British Gas or Centrica.

Will it text me codes repeatedly?

No. You enter an SMS code once; afterwards it logs in as a remembered device.

Can it change my heating by default?

No. Writes need HIVE_ALLOW_WRITES=true.

What licence is it?

MIT.

Is Hive heating free?

Yes. Hive heating is open source, so you can use and self-host it for free.

How do I add Hive heating to Claude Code?

Run this command in your terminal: claude mcp add hive-mcp --env HIVE_USERNAME='<HIVE_USERNAME>' --env HIVE_PASSWORD='<HIVE_PASSWORD>' -- docker run -i --rm -e HIVE_USERNAME -e HIVE_PASSWORD ghcr.io/mattoddie/hive-mcp:0.5.0

What are the best alternatives to Hive heating?

The closest alternatives to Hive heating are myIO, Gumball, THRIVE Fleet Intelligence, Spark Pack and ElectricityFinder.

Alternatives to Hive heating

  1. myIO

    MCP server

    Ask Claude about and control a myIO smart home controller: heating, blinds, lighting

    Runs locally
    • 1 tool
    • Open source
    • Smart home
  2. Gumball

    MCP server

    Ring, mute and set the volume of a real WiFi siren light from your AI agent

    Not checked yet
    • 6 tools
    • Remote
    • Open source
    • Smart home
  3. Free no-key MCP server with UK fleet data: fuel prices, EV charging, company car tax

    • 15 tools
    • Remote
    • Free
    • Energy and smart home
  4. Spark Pack

    MCP server

    Free MCP tools for UK electricians: cable sizing, Part P, certificate checks and G98/G99

    • 7 tools
    • Remote
    • Free
    • Home services
  5. Rank Texas electricity plans by yearly cost at your own monthly usage

    • 3 tools
    • Remote
    • Freemium
    • Energy and smart home