rachio-mcp
기능
Rachio 관개 시스템을 모든 MCP 클라이언트(Claude Code, Claude Desktop 등)에 노출하여 "지금 물을 주는 중인가요?", "앞마당에 10분만 물을 줘", "2일간 비 연기로 설정해 줘" 같은 질문을 자연어로 할 수 있습니다.
Rachio 공개 API를 사용합니다 — 클라우드 기반, 토큰 인증 방식으로 어디서든 동작합니다(컨트롤러와 같은 네트워크에 있을 필요 없음).
Related MCP server: ambient-weather-mcp
도구
도구 | 용도 |
| 계정의 모든 컨트롤러, 상태 및 구역 요약 표시 |
| 일회성 조회: 온라인 여부, 켜짐/일시정지, 강우 센서 및 지연, 현재 물주는 구역 |
| 컨트롤러의 구역 목록(번호, 이름, 활성화 여부) |
| 저장된 일정 규칙(물주기 시간) |
| 구역 하나를 N분 동안 실행 (최대 180분) |
| 여러 구역을 순차적으로 실행 |
| 지금 즉시 모든 물주기 중지 |
| 비우기 설정/해제 (0–7일) |
| 이름 또는 ID로 저장된 일정 규칙 시작 |
| 컨트롤러를 대기 모드로 전환/해제 |
구역과 장치는 API ID뿐만 아니라 이름 또는 번호로도 참조할 수 있습니다.
요구 사항
Python 3.12+
Rachio 계정 및 API 토큰
API 토큰 받기
Rachio 모바일 앱에서: 프로필 → API 키 가져오기 → 복사.
계정에 연결된 단일 베어러 토큰입니다 — 비밀번호처럼 취급하세요.
설치
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포함.로컬 / 오픈소스 모델 — MCP를 지원하는 모든 클라이언트(Cline, Continue, LibreChat, Open WebUI, Goose, Zed, Cursor)에서 Ollama, Llama, Qwen 등을 실행.
기타 모든 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