rachio-mcp

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: opensprinkler-mcp

Werkzeuge

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.