HomeButler: MCP Server for Managing Homelab Servers from Claude Without API Keys

HomeButler is an MCP (Model Context Protocol) server that enables Claude to manage homelab servers directly, eliminating the need for API keys. The tool runs locally, keeping all operations within your network.

Key Features and Commands

The source demonstrates several concrete actions Claude can perform with HomeButler:

• "Install uptime-kuma" → performs pre-checks, deploys the application, and confirms completion
• "How are my servers?" → provides status across all nodes
• "Restart nginx" → executes the restart command
• "Uninstall vaultwarden" → stops the application while preserving data

Setup Configuration

The setup requires adding HomeButler to your MCP configuration with this JSON:

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

The tool was built using Claude Code, which assisted with architecture decisions, writing tool handlers, and debugging edge cases throughout development.

HomeButler is available on GitHub at https://github.com/Higangssh/homebutler.