Hive heating
Check Hive thermostats, radiator valves and hot water, and boost heating on request
- 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.0Add 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.RequiredHIVE_PASSWORDYour Hive password, used to log in and to log in again by itself as a remembered device.RequiredHIVE_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
myIO
MCP serverAsk Claude about and control a myIO smart home controller: heating, blinds, lighting
Runs locally- 1 tool
- Open source
- Smart home

Gumball
MCP serverRing, 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
THRIVE Fleet Intelligence
MCP serverFree no-key MCP server with UK fleet data: fuel prices, EV charging, company car tax
- 15 tools
- Remote
- Free
- Energy and smart home
Spark Pack
MCP serverFree MCP tools for UK electricians: cable sizing, Part P, certificate checks and G98/G99
- 7 tools
- Remote
- Free
- Home services

ElectricityFinder
MCP serverRank Texas electricity plans by yearly cost at your own monthly usage
- 3 tools
- Remote
- Freemium
- Energy and smart home

Country energy-market bands with cited evidence, read-only for iSolOS subscribers
Not checked yet- Remote
- Paid
- Energy and smart home