Skip to main content
Glama
rachio-mcp

rachio-mcp

by rudy325

기능

Rachio 관개 시스템을 모든 MCP 클라이언트(Claude Code, Claude Desktop 등)에 노출하여 "지금 물을 주는 중인가요?", "앞마당에 10분만 물을 줘", "2일간 비 연기로 설정해 줘" 같은 질문을 자연어로 할 수 있습니다.

Rachio 공개 API를 사용합니다 — 클라우드 기반, 토큰 인증 방식으로 어디서든 동작합니다(컨트롤러와 같은 네트워크에 있을 필요 없음).

Related MCP server: ambient-weather-mcp

도구

도구

용도

list_devices

계정의 모든 컨트롤러, 상태 및 구역 요약 표시

get_status

일회성 조회: 온라인 여부, 켜짐/일시정지, 강우 센서 및 지연, 현재 물주는 구역

list_zones

컨트롤러의 구역 목록(번호, 이름, 활성화 여부)

list_schedules

저장된 일정 규칙(물주기 시간)

start_zone

구역 하나를 N분 동안 실행 (최대 180분)

start_zones

여러 구역을 순차적으로 실행

stop_watering

지금 즉시 모든 물주기 중지

set_rain_delay

비우기 설정/해제 (0–7일)

run_schedule

이름 또는 ID로 저장된 일정 규칙 시작

set_device_power

컨트롤러를 대기 모드로 전환/해제

구역과 장치는 API ID뿐만 아니라 이름 또는 번호로도 참조할 수 있습니다.

요구 사항

  • Python 3.12+

  • uv

  • 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 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
    ResponsivenessOutdated data

    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