Hearth

Sovereign home automation. Claude meets your devices.

Hearth is a Rust MCP server that controls smart home devices directly over your local network. No cloud dependency for control, no third-party wrappers. Currently drives the Meaco Arete Two 25L dehumidifier via Tuya local protocol, with Tuya Cloud API as a fallback.

wildernessinteractive.com

Architecture

Claude Code <--stdio/MCP--> hearth.exe <--Tuya Protocol/LAN--> Device
                                       <--Tuya Cloud API------> Tuya

• MCP layer: rmcp over stdio
• Local protocol: Encrypted AES-ECB over TCP, heartbeat every 10s
• Cloud fallback: Tuya Cloud API with HMAC-SHA256 auth

Tools

• get_status - Real-time device state (humidity, power, mode, faults)
• power - Turn device on/off
• set_humidity - Set target humidity (35-70%)
• set_mode - Switch mode (manual, auto, drying, continuous)
• set_child_lock - Enable/disable child lock
• set_countdown - Set timer (1h, 2h, 3h)

Setup

Build

cargo build

Configure

Create hearth.toml:

[meaco]
device_ip = "192.168.1.xxx"
device_id = "your_device_id"
local_key = "your_16char_key"

[tuya_cloud]
api_key = "your_api_key"
api_secret = "your_api_secret"
region = "eu"

Device ID and local key are obtained via TinyTuya wizard.

Connect to Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "hearth": {
      "type": "stdio",
      "command": "path/to/hearth.exe"
    }
  }
}

License

Wilderness Interactive Open License

Permission is hereby granted, free of charge, to use, copy, modify, and distribute this software for any purpose, including commercial use.

This software may NOT be:

• Sold as a standalone product
• Sold access to as a hosted service

Use for building software, building websites, automating workflows, and integrating with other tools (including commercial work) is explicitly permitted and encouraged. This software is designed to be moddable, so modifications are explicitly permitted and encouraged. Software and systems built using this tool can be sold freely.

The purpose of this license is to prevent reselling the software itself.

---

Built by Wilderness Interactive.