# HydroNode

> HydroNode is an MCP server for smart home. Hosted MCP server that lets AI assistants query and control HydroNode IoT sensors. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://hydronode.tech/docs/guide/mcp
- **Repository:** https://github.com/texhfexlabs/hydronode-mcp
- **MCP Registry name:** tech.hydronode/hydronode
- **Categories:** [smart home](https://ai-powered.com/categories/smart-home)
- **Listing updated:** 2026-11-19

## About

The HydroNode MCP server connects assistants such as Claude, ChatGPT, Cursor, VS Code and Codex to a HydroNode IoT account over Streamable HTTP. Once connected, you can ask about sensor readings, history, threshold crossings, anomalies and offline devices in everyday language, and the assistant answers from condensed summaries rather than raw data dumps.

Access is granted through OAuth 2.1 on HydroNode's own consent page. You pick which projects the assistant can see and whether it gets read-only access, permission to switch outputs and send commands, or permission to create automations. The app receives its own key rather than your password, and connected apps can be edited or revoked from the account security settings.

The README describes the server as stateless and hosted only, with a local bridge (mcp-remote) offered for clients that lack native remote MCP support. It suits people running HydroNode sensors and controls who want to check their data or operate devices from an AI chat or code editor.

## Features

- **Plain-language sensor queries:** Ask about current values, past readings and trends for sensors and data points by name.
- **Historical summaries:** Get min, max, average, trend and gap information over a chosen time span, returned as condensed buckets.
- **Threshold and period search:** Find when a value was above or below a line and for how long.
- **Scoped access control:** Choose read, switch, command or automation rights and limit access to selected projects.
- **Device control with audit trail:** Switch outputs or send commands, with each action shown in the device console under the app's name.
- **Anomaly and offline checks:** List open anomalies with explanations and find devices reporting problems.

## Good for

- Checking how a greenhouse, cellar or soil sensor behaved over the past week
- Finding out why a sensor has gone offline
- Comparing current sensor readings with an earlier period
- Switching a pump or output off from an AI assistant
- Setting up a notification when a tank level drops below a threshold

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hydronode https://hydronode.tech/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://hydronode.tech/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hydronode": {
      "url": "https://hydronode.tech/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hydronode": {
      "type": "http",
      "url": "https://hydronode.tech/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hydronode": {
      "serverUrl": "https://hydronode.tech/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://hydronode.tech/mcp
```

Enter a Name (for example "HydroNode"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hydronode": {
      "type": "http",
      "url": "https://hydronode.tech/mcp"
    }
  }
}
```

## Tools

- `overview`: Projects, device status, open anomalies, unread messages and items needing attention.
- `find`: Search sensors, data points, stations and projects by name, id or DevEUI.
- `get_sensor`: Return one sensor with status, battery, signal, firmware and data points.
- `summarize_history`: Min, max, average, trend and gaps over a time span.
- `find_periods`: Find when a value was below or above a threshold and for how long.
- `compare`: Compare up to four data points, or one point against an earlier span.
- `list_anomalies`: List detected anomalies.
- `get_anomaly`: Return the explanation for one anomaly.
- `list_messages`: List the inbox.
- `mark_messages`: Mark messages as read, unread, archived or restored.
- `device_health`: List only devices with problems.
- `console`: Show latest device requests and rejection reasons.
- `public_stations`: Find public stations by name or location.
- `list_automations`: List automations, optionally with recent runs.
- `set_value`: Switch or set a writable data point.
- `send_command`: Queue a typed device command.
- `log_value`: Record a manual measurement.
- `toggle_automation`: Turn an automation on or off.
- `create_automation`: Create an automation; dry run by default, no webhooks.

## FAQ

### How do I connect it?

Add the server URL https://hydronode.tech/mcp as a custom connector or MCP server in your client; the README lists setup steps for Claude, ChatGPT, Cursor, VS Code and Codex.

### Can the assistant read my password or session?

No. The documentation says the app gets its own key that only works through the MCP server, and it never sees your password or HydroNode session.

### Can it delete data or change account settings?

The documentation states the key cannot delete, share, change account settings or perform firmware updates.

### Is it free?

The content does not describe pricing.

### How do I add HydroNode to Claude Code?

Run this command in your terminal: claude mcp add --transport http hydronode https://hydronode.tech/mcp

### What are the best alternatives to HydroNode?

The closest alternatives to HydroNode are Heiman Smart Home, Home Automation Mcp and Ctrlpi MCP.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Heiman Smart Home](https://ai-powered.com/mcp/heiman-smart-home): Heiman Smart Home is an open-source MCP server for smart home.
- [Home Automation Mcp](https://ai-powered.com/mcp/home-automation-mcp): Home Automation Mcp is a freemium MCP server for smart home.
- [Ctrlpi MCP](https://ai-powered.com/mcp/ctrlpi-mcp): Ctrlpi MCP is an open-source MCP server for smart home.

---
Source: https://ai-powered.com/mcp/hydronode
