iaqualink-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iaqualink-mcpTurn on the pool pump and set the spa temperature to 100°F."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
iaqualink-mcp
An MCP server that exposes a Jandy iAqualink pool/spa system to Claude
(or any MCP client). It wraps the iaqualink
Python library.
Tools provided:
list_systems— all systems on the accountlist_devices— all devices on a systemget_device— state of one deviceget_system_status— system + every device's state in one callturn_on/turn_off/toggle_deviceset_temperature— thermostat set pointsset_light_effect/set_light_rgbw/set_light_brightness— ICL/IntelliCenter lights
Set IAQUALINK_READ_ONLY=true to disable every write tool and only allow reads.
Install
From GitHub (once pushed)
uv tool install git+https://github.com/jgonzalez007/iaqualink-mcpFrom a local clone (recommended for development, and avoids uvx
having to clone/build the project on every launch)
git clone https://github.com/jgonzalez007/iaqualink-mcp
cd iaqualink-mcp
uv tool install .Either way this registers a command called iaqualink-mcp that uvx/uv tool
can run directly.
Related MCP server: Enhanced Home Assistant MCP
Configure Claude Desktop
Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or
~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
and add:
{
"mcpServers": {
"iaqualink": {
"command": "uvx",
"args": ["iaqualink-mcp"],
"env": {
"IAQUALINK_USERNAME": "you@example.com",
"IAQUALINK_PASSWORD": "your-iaqualink-password"
}
}
}
}Add "IAQUALINK_READ_ONLY": "true" to env if you only want Claude to read
status, never control equipment.
Then fully quit Claude Desktop from the system tray (not just close the window) and relaunch it.
Development
git clone https://github.com/jgonzalez007/iaqualink-mcp
cd iaqualink-mcp
uv sync --extra dev
# Run tests
uv run pytest
# Lint
uvx ruff check .Copy .env.example to .env and fill in your credentials for local manual
testing; .env is gitignored.
Contributing
Issues and pull requests are welcome. Please run pytest and ruff check .
before opening a PR.
Notes
This uses a reverse-engineered/unofficial API (via
iaqualink-py); Jandy/ Zodiac/Fluidra don't publish an official one. Use at your own risk.Credentials are read from environment variables only — nothing is written to disk by this server.
Your
claude_desktop_config.jsonwill contain your iAqualink password in plaintext. Don't commit that file or share it, and treat it like any other credential store on your machine.
License
MIT — see LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
- mytesla.ioOAuthio.mytesla
Control your Tesla from your AI assistant - climate, charging, access, and security.
Manage digital signage screens, playlists and media from your AI assistant.
Manage fitness coaching clients, workouts, programs, chats and funnels from your assistant.
Manage your IoT device fleet directly from Claude. Create device templates with datastreams and events, provision new devices, read live sensor data, and control outputs. The Blynk connector integrates with the Blynk IoT platform, enabling direct configuration and monitoring of connected devices and infrastructure.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to control Bond Bridge smart home devices including ceiling fans, motorized shades, dimmable lights, and other RF-controlled devices. Provides comprehensive device management and control capabilities through the Bond Local API.10MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive control and monitoring of Home Assistant smart home devices, automations, scenes, and system management through AI assistants. Supports lights, climate, media players, notifications, history tracking, and advanced automation workflows.4 npm2MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Philips Hue smart lighting systems, including individual lights, groups, scenes, brightness, and color adjustments through natural language commands.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Home Assistant smart home devices through natural language. Control devices, manage automations, query entity states, and retrieve historical data across your home automation system.1MIT