Skip to main content
Glama
rachio-mcp

rachio-mcp

by rudy325

できること

Rachio の散水システムを、あらゆる MCP クライアント(Claude Code、Claude Desktop など)から使えるようにします。「今、何か散水していますか?」、「前庭の芝を10分間散水して」、「2日間のレインデレイに設定して」 というように、自然言語で指示できます。

Rachio public API を使用しています。クラウド型・トークンベースで、どこからでも動作します(コントローラーと同じネットワークにいる必要はありません)。

Related MCP server: ambient-weather-mcp

ツール

ツール

目的

list_devices

アカウント上の全コントローラーと、ステータスとゾーン概要

get_status

その瞬間の状態: オンライン、オン / 一時停止、雨センサー&レインダレイ、現在散水中のゾーン

list_zones

コントローラーのゾーン一覧(番号、名前、有効 / 無効)

list_schedules

保存されたスケジュールルール(散水時刻)

start_zone

1つのゾーンを N 分間実行(最大 180 分)

start_zones

複数のゾーンを順番に実行

stop_watering

現在の散水をすべて停止

set_rain_delay

レインダレイを設定 / 解除(0〜セブン日)

run_schedule

保存されたスケジュールルールを名前または ID で開始

set_device_power

コントローラーをスタンバイへ出す / 復帰する

ゾーンとデバイスは、API の ID だけでなく、名前または番号でも指定できます。

要件

  • Python 3.12+

  • uv

  • Rachio アカウントと API トークン

API トークンを取得する

Rachio モバイルアプリで: Profile → Get API Key → Copy。 これはアカウントに紐づく単一のベアラトークンです。パスワードと同等に扱ってください。

インストール

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

設定

export RACHIO_API_TOKEN=your-api-token

.env.example を参照してください。

Claude Code に登録する

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

または Claude Desktop では、claude_desktop_config.json に:

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

他のクライアント(OpenAI、ローカルモデルなど)で使う

これは標準的な MCP サーバーです。stdio 経由でオープンプロトコルを話し、どのモデルやクライアントが動かしているかは問いません。MCP に対応しているものなら何でも動作します:

  • OpenAI — Agents SDK と Responses API は MCP サーバーを受け入れます。次のように指定します: command: "uv", args: ["--directory", "/path/to/rachio-mcp", "run", "server.py"]、環境内の RACHIO_API_TOKEN に設定します。

  • ローカル / オープンソースモデル — Ollama、Llama、Qwen などを実行している MCP 対応クライアント(Cline、Continue、LibreChat、Open WebUI、Goose、Zed、Cursor)経由で利用できます。

  • その他の MCP クライアント — 上記 Claude の例と同じ stdio コマンドを使用します。

唯一の条件は、ツール / 関数呼び出しを得意とするモデルであることです。大規模なホスト型モデルや高性能なローカルモデル(Llama 3.1+、Qwen 2.5+)なら問題なく処理できます。

注意事項

  • 複数のコントローラー: すべてのツールは省略可能な device 引数(名前または ID)を受け取り、アカウントに複数のコントローラーがある場合にのみ必要です。

  • 実行時間: ゾーンの実行は最大 180 分、レインダーは最大 7 日で、API の制限に合わせています。

  • スタンバイ: set_device_power(on=false) でコントローラーをスタンバイにし、再度オンにするまで予定された散水をすべて一時停止します。

  • レート制限: Rachio API はトークンごとに毎日 1700 回の呼び出しを許可します。これらのツールはすべて単一の呼び出しであるため、通常の使用では上限に達することはありません。

全体の仕組み

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

ライセンス

MIT。Rachio, Inc. とは提携・推薦の関係はありません。
「Rachio」は 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