rachio-mcp
できること
Rachio の散水システムを、あらゆる MCP クライアント(Claude Code、Claude Desktop など)から使えるようにします。「今、何か散水していますか?」、「前庭の芝を10分間散水して」、「2日間のレインデレイに設定して」 というように、自然言語で指示できます。
Rachio public API を使用しています。クラウド型・トークンベースで、どこからでも動作します(コントローラーと同じネットワークにいる必要はありません)。
Related MCP server: ambient-weather-mcp
ツール
ツール | 目的 |
| アカウント上の全コントローラーと、ステータスとゾーン概要 |
| その瞬間の状態: オンライン、オン / 一時停止、雨センサー&レインダレイ、現在散水中のゾーン |
| コントローラーのゾーン一覧(番号、名前、有効 / 無効) |
| 保存されたスケジュールルール(散水時刻) |
| 1つのゾーンを N 分間実行(最大 180 分) |
| 複数のゾーンを順番に実行 |
| 現在の散水をすべて停止 |
| レインダレイを設定 / 解除(0〜セブン日) |
| 保存されたスケジュールルールを名前または ID で開始 |
| コントローラーをスタンバイへ出す / 復帰する |
ゾーンとデバイスは、API の ID だけでなく、名前または番号でも指定できます。
要件
Python 3.12+
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 toolsget_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
Scored across 10 tools
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.
Tool names follow a consistent verb_noun pattern throughout: list_*, start_*, set_*, stop_*, run_*. Even the plural start_zones follows logically from start_zone.
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.
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
Related MCP Connectors
Control your Tesla from your AI assistant - climate, charging, access, and security.
Read RemoteLock devices and guests; manage door access and physically lock or unlock doors.
Control your existing Philips lights, Sonos speakers, Roborock vacuums and other supported devices through Port OS cloud. Give ChatGPT, Claude and other MCP-compatible assistants access to the devices you connect. Turn off the living room lights, play music on your speakers, adjust the thermostat, run a vacuum in a room, check a camera snapshot or find a connected tracker. Available actions depend on your linked provider accounts and each device’s supported capabilities. Port OS runs in the cloud; no local server is required. You choose the account, device and capability permissions each assistant receives. Device operations require user OAuth; public tool discovery does not grant device access. Port OS is in alpha. Setup: https://portoperatingsystem.com/docs/getting-started/ Support: https://portoperatingsystem.com/contact/
Ask about your IoT sensors, devices, anomalies and automations, switch outputs and log values.
Related MCP Servers
- FlicenseNot gradedqualityFmaintenanceEnables managing OpenSprinkler irrigation controllers via Claude Desktop, including starting/stopping stations, setting rain delays, and viewing controller status.-
- AlicenseNot gradedqualityDmaintenanceEnables natural language queries about Ambient Weather personal weather station data, including current conditions and device info.MIT
- AlicenseAqualityCmaintenanceMCP 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.248MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.1MIT