MCP server for HomeButler, which remembers what a server looked like last time and tells an agent what changed as typed JSON — every tool classed read, write or destructive.

This is an npm wrapper for homebutler. It downloads the correct binary for your platform automatically.

Quick Setup

Add to your MCP client config (Claude Code, Cursor, Claude Desktop, ChatGPT Desktop):

{
  "mcpServers": {
    "homebutler": {
      "command": "npx",
      "args": ["-y", "homebutler-mcp"]
    }
  }
}

That's it. No manual installation needed.

Try Without Real Servers

{
  "mcpServers": {
    "homebutler": {
      "command": "npx",
      "args": ["-y", "homebutler-mcp", "--demo"]
    }
  }
}

Demo mode returns realistic fake data — perfect for trying it out.

Available Tools

Tool	Description
`system_status`	CPU, memory, disk, uptime
`docker_list`	List containers
`docker_restart`	Restart a container
`docker_stop`	Stop a container
`docker_logs`	Container log output
`wake`	Wake-on-LAN magic packet
`open_ports`	Open ports with process info
`network_scan`	Discover LAN devices
`alerts`	Resource threshold alerts