iaqualink-mcp

Un servidor MCP que expone un sistema de piscina/spa Jandy iAqualink a Claude (o a cualquier otro cliente MCP). Envuelve la biblioteca de Python iaqualink.

Herramientas incluidas:

• list_systems — todos los sistemas de la cuenta

• list_devices — todos los dispositivos de un sistema

• get_device — estado de un dispositivo

• get_system_status — estado del sistema y de todos los dispositivos en una sola llamada

• turn_on / turn_off / toggle_device

• set_temperature — puntos de consigna del termostato

• set_light_effect / set_light_rgbw / set_light_brightness — luces ICL/IntelliCenter

Define IAQUALINK_READ_ONLY=true para desactivar todas las herramientas de escritura y permitir solo lecturas.

Instalación

Desde GitHub (una vez subido)

uv tool install git+https://github.com/yourusername/iaqualink-mcp

Desde un clon local (recomendado para desarrollo, ya que evita que uvx

clone el proyecto en cada lanzamiento)

git clone https://github.com/yourusername/iaqualink-mcp
cd iaqualink-mcp
uv tool install .

En ambos casos, queda registrado un comando llamado iaqualink-mcp que uvx/uv tool pueden ejecutar directamente.

Related MCP server: Enhanced Home Assistant MCP

Configurar Claude Desktop

Edita %APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) y añade:

{
  "mcpServers": {
    "iaqualink": {
      "command": "uvx",
      "args": ["iaqualink-mcp"],
      "env": {
        "IAQUALINK_USERNAME": "you@example.com",
        "IAQUALINK_PASSWORD": "your-iaqualink-password"
      }
    }
  }
}

Añade "IAQUALINK_READ_ONLY": "true" a env si solo quieres que Claude lea el estado y nunca controle los equipos.

A continuación, cierra Claude Desktop por completo desde la bandeja del sistema (no basta con cerrar la ventana) y vuélvelo a lanzar.

Desarrollo

git clone https://github.com/yourusername/iaqualink-mcp
cd iaqualink-mcp
uv sync --extra dev

# Run tests
uv run pytest

# Lint
uvx ruff check .

Copia .env.example a .env y completa tus credenciales para las pruebas manuales locales; .env está ignorado por Git.

Contribuciones

Son bienvenidos los issues y las pull requests. Ejecuta pytest y ruff check . antes de abrir una PR.

Notas

• Utiliza una API no oficial obtenida mediante ingeniería inversa (vía iaqualink-py); Jandy/ Zodiac/Fluidra no publican una API oficial. Úsala bajo tu propia responsabilidad.

• Las credenciales se leen únicamente de variables de entorno — este servidor no escribe nada en el disco.

• Tu claude_desktop_config.json contendrá tu contraseña de iAqualink en texto plano. No hagas commit de ese archivo ni lo compartas, y trátalo como cualquier otro almacén de credenciales de tu máquina.

Licencia

MIT — consulta LICENSE.