rachio-mcp

Qué hace

Expone tu sistema de riego Rachio a cualquier cliente MCP (Claude Code, Claude Desktop, etc.) para que puedas preguntar "¿está regando algo ahora mismo?", "riega el césped delantero durante 10 minutos" o "ponlo en un retraso por lluvia de 2 días" en lenguaje natural.

Utiliza la API pública de Rachio — en la nube, basada en tokens, funciona desde cualquier lugar (no es necesario estar en la misma red que el controlador).

Related MCP server: opensprinkler-mcp

Herramientas

Las zonas y los dispositivos se pueden referenciar por nombre o número, no solo por sus ids de API.

Requisitos

• Python 3.12+

• uv

• Una cuenta de Rachio y un token de API

Obtén tu token de API

En la aplicación móvil de Rachio: Profile → Get API Key → Copy. Es un único token de portador vinculado a tu cuenta — trátalo como una contraseña.

Instalación

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

Configuración

export RACHIO_API_TOKEN=your-api-token

Consulta .env.example.

Registro con Claude Code

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

O con Claude Desktop, en claude_desktop_config.json:

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

Usar con otros clientes (OpenAI, modelos locales, etc.)

Este es un servidor MCP estándar — habla el protocolo abierto a través de stdio y no le importa qué modelo o cliente lo controle. Cualquier cosa que admita MCP funciona:

• OpenAI — el Agents SDK y la Responses API aceptan servidores MCP. Apúntalos a: command: "uv", args: ["--directory", "/path/to/rachio-mcp", "run", "server.py"], con RACHIO_API_TOKEN en el entorno.

• Modelos locales / de código abierto — a través de cualquier cliente compatible con MCP (Cline, Continue, LibreChat, Open WebUI, Goose, Zed, Cursor) que ejecute Ollama, Llama, Qwen, etc.

• Cualquier otro cliente MCP — el mismo comando stdio que los ejemplos de Claude anteriores.

El único requisito es un modelo competente en la llamada a herramientas/funciones; los grandes modelos alojados y los locales más potentes (Llama 3.1+, Qwen 2.5+) lo manejan bien.

Notas

• Varios controladores: cada herramienta acepta un argumento device opcional (nombre o id), obligatorio solo cuando la cuenta tiene más de un controlador.

• Duraciones: las ejecuciones de zonas están limitadas a 180 minutos y los retrasos por lluvia a 7 días, en línea con los límites de la API.

• Modo de espera: set_device_power(on=false) pone el controlador en modo de espera, pausando todo el riego programado hasta que se vuelva a activar.

• Límites de uso: la API de Rachio permite 1700 llamadas/día por token; estas herramientas son todas llamadas individuales, por lo que el uso normal está muy lejos del límite.

Cómo encaja todo

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

Licencia

MIT. No afiliado ni respaldado por Rachio, Inc. «Rachio» es una marca comercial de Rachio, Inc.