Skip to main content
Glama
rachio-mcp

rachio-mcp

by rudy325

Was es tut

Macht Ihr Rachio-Bewässerungssystem für jeden MCP-Client verfügbar (Claude Code, Claude Desktop usw.), sodass Sie in natürlicher Sprache fragen können: „Bewässert gerade etwas?“, „Bewässere den Vorgarten für 10 Minuten“ oder „Setze eine 2-tägige Regenverzögerung“.

Verwendet die öffentliche Rachio-API — cloudbasiert, tokenbasiert, funktioniert von überall (kein Aufenthalt im selben Netzwerk wie der Controller erforderlich).

Related MCP server: ambient-weather-mcp

Werkzeuge

Werkzeug

Zweck

list_devices

alle Controller auf dem Konto, mit Status und Zonenübersicht

get_status

einmalig: online, ein/pausiert, Regensensor & Verzögerung, was gerade bewässert wird

list_zones

Zonen auf einem Controller (Nummer, Name, aktiviert)

list_schedules

gespeicherte Zeitplanregeln (Bewässerungszeiten)

start_zone

eine Zone für N Minuten laufen lassen (max. 180)

start_zones

mehrere Zonen nacheinander laufen lassen

stop_watering

alles sofort stoppen

set_rain_delay

Regenverzögerung setzen/aufheben (0–7 Tage)

run_schedule

eine gespeicherte Zeitplanregel nach Name oder ID starten

set_device_power

Controller in den Standby-Modus versetzen / aus dem Standby holen

Zonen und Geräte können per Name oder Nummer referenziert werden, nicht nur über ihre API-IDs.

Anforderungen

  • Python 3.12+

  • uv

  • Ein Rachio-Konto und ein API-Token

API-Token abrufen

In der Rachio-Mobil-App: Profile → Get API Key → Copy. Es ist ein einzelnes Bearer-Token, das an Ihr Konto gebunden ist — behandeln Sie es wie ein Passwort.

Installation

git clone https://github.com/rudy325/rachio-mcp.git
cd rachio-mcp
uv sync

Konfiguration

export RACHIO_API_TOKEN=your-api-token

Siehe .env.example.

Bei Claude Code registrieren

claude mcp add rachio \
  --env RACHIO_API_TOKEN=your-api-token \
  -- uv --directory /path/to/rachio-mcp run server.py

Oder mit Claude Desktop in claude_desktop_config.json:

{
  "mcpServers": {
    "rachio": {
      "command": "uv",
      "args": ["--directory", "/path/to/rachio-mcp", "run", "server.py"],
      "env": { "RACHIO_API_TOKEN": "your-api-token" }
    }
  }
}

Verwendung mit anderen Clients (OpenAI, lokale Modelle usw.)

Dies ist ein standardmäßiger MCP-Server — er spricht das offene Protokoll über stdio und kümmert sich nicht darum, welches Modell oder welcher Client ihn steuert. Alles, was MCP unterstützt, funktioniert:

  • OpenAI — das Agents SDK und die Responses API akzeptieren MCP-Server. Weisen Sie sie an: command: "uv", args: ["--directory", "/path/to/rachio-mcp", "run", "server.py"], mit RACHIO_API_TOKEN in der Umgebung.

  • Lokale / Open-Source-Modelle — über jeden MCP-fähigen Client (Cline, Continue, LibreChat, Open WebUI, Goose, Zed, Cursor) mit Ollama, Llama, Qwen usw.

  • Jeder andere MCP-Client — derselbe stdio-Befehl wie in den obigen Claude-Beispielen.

Die einzige Voraussetzung ist ein Modell, das kompetent im Tool-/Funktionsaufruf ist; die großen gehosteten Modelle und stärkere lokale Modelle (Llama 3.1+, Qwen 2.5+) kommen damit gut zurecht.

Hinweise

  • Mehrere Controller: Jedes Werkzeug akzeptiert ein optionales device-Argument (Name oder ID), das nur erforderlich ist, wenn das Konto mehr als einen Controller hat.

  • Dauern: Zonenläufe sind auf 180 Minuten begrenzt und Regenverzögerungen auf 7 Tage, entsprechend den API-Limits.

  • Standby: set_device_power(on=false) versetzt den Controller in den Standby-Modus und pausiert alle geplanten Bewässerungen, bis er wieder eingeschaltet wird.

  • Ratenlimits: Die Rachio-API erlaubt 1700 Aufrufe pro Tag und Token; diese Werkzeuge sind alle einzelne Aufrufe, daher ist die normale Nutzung weit von der Grenze entfernt.

Wie alles zusammenpasst

MCP client ──stdio──> server.py ──HTTPS──> api.rach.io/1 ──> your Rachio controller

Lizenz

MIT. Nicht verbunden mit oder unterstützt von Rachio, Inc. „Rachio“ ist eine Marke von Rachio, Inc.

Available Tools

10 tools
get_statusA

Current state of a controller: online, on/paused, rain sensor/delay, and what (if anything) is watering right now. The one call for "what's my sprinkler doing".

Inputs: device.

list_devicesA

List Rachio controllers on the account with status and zone summary.

Inputs: no named parameters. Returns: result

list_schedulesB

List the stored schedule rules (watering times) on a controller.

Inputs: device. Returns: result

list_zonesA

List every zone on a controller (number, name, enabled state).

Inputs: device. Returns: result

run_scheduleB

Start a stored schedule rule by its id or name.

Inputs: schedule (required), device.

set_device_powerA

Turn a controller's automatic schedules on (standby off) or off (standby on). Turning it off pauses all scheduled watering until turned back on.

Inputs: on (required), device.

set_rain_delayB

Set a rain delay in days (0 clears it, max 7).

Inputs: days (required), device.

start_zoneC

Run a single zone for the given number of minutes (max 180).

Inputs: zone (required), minutes (required), device.

start_zonesA

Run multiple zones in sequence. Each item: {"zone": <num/name>, "minutes": }. They water one after another in the order given.

Inputs: zones (required), device.

stop_wateringB

Stop all watering on a controller immediately (manual or scheduled).

Inputs: device.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools clearly target distinct actions and resources, such as listing devices, zones, and schedules or setting rain delay. The main potential confusion is between start_zone, start_zones, and run_schedule, though descriptions clarify the differences.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern throughout: list_*, start_*, set_*, stop_*, run_*. Even the plural start_zones follows logically from start_zone.

    Tool Count5/5

    10 tools is well-scoped for an irrigation controller server. Each tool covers a meaningful control or query action without unnecessary bloat or missing essential functionality.

    Completeness4/5

    The server covers core device management, zone control, schedule execution, status, and watering control. Minor gaps exist like detailed watering history or schedule editing, but the main local control workflows are complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      F
      maintenance
      Enables managing OpenSprinkler irrigation controllers via Claude Desktop, including starting/stopping stations, setting rain delays, and viewing controller status.
      -
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for full control of Rachio sprinkler controllers via the reverse-engineered internal gRPC API, enabling schedule management, manual zone runs, rain delays, and weather data retrieval.
      24
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables natural-language control and monitoring of Rain Bird ESP-TM2 irrigation controllers over a local LAN, including starting zones, running programs, setting rain delays, and checking status.
      1
      MIT