Skip to main content
Glama
BrianVia

ecobee-mcp

by BrianVia
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

ecobee-mcp

A remote Model Context Protocol server for one Ecobee account, hosted on Cloudflare Workers. It reads thermostat status and controls modes, holds, schedules, settings, vacations, fan time, and screen messages.

One Worker serves a bearer-protected, stateless /mcp endpoint. A Durable Object owns and refreshes the account's access tokens.

Setup

npm install
npx wrangler login
cp wrangler.jsonc wrangler.local.jsonc

In wrangler.local.jsonc, replace ecobee.example.com with a hostname on a Cloudflare zone you manage. Deploy using that local config:

WRANGLER_CONFIG=wrangler.local.jsonc npm run deploy
npx wrangler secret put ECOBEE_USERNAME --config wrangler.local.jsonc
npx wrangler secret put ECOBEE_PASSWORD --config wrangler.local.jsonc
openssl rand -hex 32 | tee /dev/stderr | npx wrangler secret put MCP_BEARER --config wrangler.local.jsonc

The custom-domain route creates its DNS record on first deploy.

Related MCP server: Home Assistant MCP

Tools

Tool

Description

get_thermostats

Summarize all registered thermostats

get_thermostat

Get selected raw details for one thermostat

set_hvac_mode

Change HVAC mode

set_hold

Set heat and cool hold temperatures

resume_schedule

Cancel holds and resume the programmed schedule

set_fan_min_on_time

Set minimum fan minutes per hour

update_settings

Pass through raw thermostat settings

update_program

Pass through comfort profiles or a weekly schedule

set_comfort_sensors

Choose which sensors a comfort setting (Home/Away/Sleep…) averages, by sensor name

create_vacation

Create a vacation event

delete_vacation

Delete a vacation event

send_message

Show a message on the thermostat screen

Write tools change the real thermostat. Confirm changes with the user first.

Raw HTTP

The endpoint uses stateless Streamable HTTP and returns SSE-framed MCP responses.

curl -s https://ecobee.example.com/mcp -X POST \
  -H 'Authorization: Bearer <MCP_BEARER>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

GET / identifies the MCP endpoint. GET /health is public and reports whether the Durable Object has tokens without making a network request.

Local development

cp .dev.vars.example .dev.vars
npm run check
npx wrangler dev

Notes

  • Authentication uses the Ecobee web app's public Auth0 client and password grant. This is unofficial and may break if Ecobee changes that flow.

  • No browser authorization is needed.

  • Sensor participation is per comfort setting, but Ecobee's Follow Me (followMeComfort) overrides it with whichever sensors detect motion. get_thermostats shows both; turn Follow Me off with update_settings {"followMeComfort": false} for strict per-setting sensors.

  • Tool temperatures are plain °F. Raw settings and program temperature fields use °F × 10 where noted.

  • Credentials are Worker secrets and are sent only to Ecobee's Auth0 token endpoint.

  • /mcp requires MCP_BEARER; / and /health are public.

License

MIT. See LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Tesla MCP Server

    iceener
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables control and monitoring of Tesla vehicles through the Tessie API, providing access to vehicle state (battery, location, climate) and commands (lock/unlock, climate control, navigation) with support for both local and Cloudflare Worker deployment.
    11
    MIT

  • Home Assistant MCP

    crunchypancake1
    A
    license
    Not graded
    quality
    B
    maintenance
    Exposes a Home Assistant instance as an MCP tool set, running as a stateful agent on Cloudflare Workers, enabling clients to read entity states, call services, run scripts and automations, and send commands to phones.
    83 npm
    Apache 2.0

  • Garmin Cloud MCP

    RedlineTriad
    F
    license
    Not graded
    quality
    B
    maintenance
    A stateless MCP server for Cloudflare Workers that exposes read-only Garmin Connect data (activities, health, sleep, training status, HRV, VO2 max) for a single securely linked personal account.
    -

  • myUplink MCP Server

    Alastair-Pandelus
    A
    license
    Not graded
    quality
    C
    maintenance
    Connects MCP clients such as Claude to a NIBE myUplink heat-pump account, letting users list systems and devices, read sensor values and common parameters, check alarms, view smart-home zones, and write settings where scopes allow. Handles the OAuth2 authorization-code and client-credentials flows, refreshing tokens automatically while keeping credentials in a local .env file.
    MIT