# Hive heating

> Hive heating is an open-source MCP server for smart home. Check Hive thermostats, radiator valves and hot water, and boost heating on request. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, macOS, Windows, Linux, CLI
- **Website:** https://hive-mcp.mattoddie.dev
- **Repository:** https://github.com/mattoddie/hive-mcp
- **MCP Registry name:** io.github.mattoddie/hive-mcp
- **Categories:** smart home, energy and smart home
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

## 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

- [myIO](https://ai-powered.com/mcp/myio): myIO is an open-source MCP server for smart home.
- [Gumball](https://ai-powered.com/mcp/gumball): Gumball is an open-source MCP server for smart home.
- [THRIVE Fleet Intelligence](https://ai-powered.com/mcp/thrive-fleet-intelligence): THRIVE Fleet Intelligence is a free MCP server for energy and smart home.
- [Spark Pack](https://ai-powered.com/mcp/spark-pack): Spark Pack is a free MCP server for home services.
- [ElectricityFinder](https://ai-powered.com/mcp/electricityfinder): ElectricityFinder is a freemium MCP server for energy and smart home.
- [(iS)NEPI - National Energy Performance Index](https://ai-powered.com/mcp/is-nepi-national-energy-performance-index): (iS)NEPI - National Energy Performance Index is a paid MCP server for energy and smart home.
- [Barrio Grid](https://ai-powered.com/mcp/barrio-grid): Barrio Grid is a freemium MCP server for energy and smart home.
- [AgentDataAPI](https://ai-powered.com/mcp/agentdataapi): AgentDataAPI is a freemium MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/hive-heating
