ecobee-mcp

ecobee MCP

MCP server for ecobee thermostats: list, runtime, sensors. Needs API key + tokens.

Setup (one-time PIN flow)

• Get an API key at https://www.ecobee.com/home/developer/ (free).
• Get a PIN: open https://api.ecobee.com/authorize?response_type=ecobeePin&client_id=YOUR_KEY&scope=smartRead — it shows a 4-character code.
• Within 9 minutes, enter the code at https://www.ecobee.com/consumerportal/.
• Exchange it for tokens:

  curl -X POST 'https://api.ecobee.com/token' \
    -d 'grant_type=ecobeePin&code=YOUR_PIN&client_id=YOUR_KEY'
  

  Save the refresh_token, then:

export ECOBEE_API_KEY=your_key
export ECOBEE_REFRESH_TOKEN=your_refresh_token
npm install
npm run build
node dist/index.js

The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code, MCP Inspector, or another compatible MCP client. It auto-refreshes the access token.

Tools at a glance

• list_thermostats: Temperature, humidity, mode, sensors.

Limits and privacy

This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. Credentials stay local and go only to ecobee's API. All tools are read-only.