Skip to main content
Glama

easee-mcp

An Easee car charger's status, read by voice: a read-only MCP server and claude-voice plugin.

It answers four questions by voice: is the car charging and how fast, what current the charger may give, how many charging sessions there were lately, and how much energy went in today, this week or this month. It only reads. It never starts, stops or changes the charger, and a test proves it cannot; see ADR-EM-001.

Try it on a made-up charger, with no login and nothing sent:

$ easee-mcp status --simulate
Simulated: Garasje is charging at 7.2 kW, 12.4 kWh this session. It is limited to 16 A.

For the real charger, save the Easee username and password as user and password in ~/.config/easee-mcp/, readable by you alone. They are read only when a question is asked, and never printed or logged. The charger is found on the account each time the plugin starts; its ID is never written anywhere.

A voice session starts it as an MCP server over stdio:

$ easee-mcp serve --help
usage: easee-mcp serve [-h] [--simulate] [--login-dir LOGIN_DIR]

options:
  -h, --help            show this help message and exit
  --simulate            answer from a made-up charger
  --login-dir LOGIN_DIR
                        the folder holding 'user' and 'password' (default ~/.config/easee-mcp)

Easee allows the charger list twice a minute, and sessions and energy ten reads an hour each. So the plugin keeps the state for 30 seconds, sessions for ten minutes and energy for thirty. Past a limit it sends nothing, and gives the last answer with its age, or says how long to wait.

The gates

Every one of these runs in continuous integration, and all of them run here:

$ uv run ruff check .
All checks passed!
uv run ruff format --check .   # layout
uv run mypy src                # types
uv run pytest -q               # behaviour
python scripts/mutate.py       # that each rule's own test can fail

CONTRIBUTING.md says what each one is for, and decisions/ records the choices that shaped them, including how a change is made here.

Related MCP server: shelly-api-mcp

Licence

GPL-3.0-or-later. See LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only access to vehicle data via the unofficial Rivian GraphQL API, allowing users to monitor battery levels, OTA updates, and charging status. It provides tools to check vehicle state and user account information directly through Claude.
      9
      424 npm
      4
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Provides read-only access to Shelly Cloud energy data, including live power, lifetime energy, and historical consumption with cost, enabling AI agents to monitor electricity usage without device control.
      1
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables querying Tibber electricity prices, forecasts, consumption data, cheapest hours, and live Pulse measurements through natural language.
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables controlling Zaptec EV chargers through natural language, including checking charging status, viewing charge history with cost, pausing and resuming sessions, and setting available current.
      6
      2
      MIT