Lightweave MCP

Installable MCP server for controlling Apple Home, Philips Hue, and Nanoleaf lights from Claude Desktop, backed by the Lightweave Supabase account database.

It is designed for natural requests like:

set my study lights to a colour to ease my mood im cosy and yet nervous

The server treats Supabase as the account base, then stores only machine-local execution details at ~/.lightweave-mcp/config.json by default. Set LIGHTWEAVE_MCP_CONFIG=/path/to/config.json to use another file.

Apple Home commands are queued through Supabase for the signed-in Lightweave app to apply through HomeKit. Direct Hue and Nanoleaf bridge tokens stay local on the user's computer.

Build

npm install
npm run build

Claude Desktop

Once published to npm, users can add it with npx:

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

For local development, add this server to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "lightweave": {
      "command": "node",
      "args": [
        "/Users/harryphillips/Documents/PhillCon/mcp/lightweave-mcp/dist/index.js"
      ]
    }
  }
}

Restart Claude Desktop after editing the file.

First Pairing

Use Claude to call:

• sign_in_lightweave_account with the user's Lightweave email and password
• sync_lightweave_supabase to pull their account profile
• Connect Apple Home in the Lightweave app so HomeKit lights sync to Supabase
• refresh_lights to pull the latest direct Hue/Nanoleaf devices if using those too
• pair_hue_bridge after pressing the Hue bridge link button, only for direct Hue control
• pair_nanoleaf_controller after putting the Nanoleaf controller into pairing mode, only for direct Nanoleaf OpenAPI control
• create_room to name a room like Study

Apple Home devices are controlled by the Lightweave app through HomeKit. If the command is not completed immediately, it remains queued in Supabase until the signed-in Lightweave app checks in.

Supabase

The PhillCon Supabase project is used by default:

• URL: https://iixtjzcautbrquokbiva.supabase.co
• publishable key: read from the bundled default or LIGHTWEAVE_SUPABASE_PUBLISHABLE_KEY

Each MCP action pulls the signed-in user's rows before acting and pushes updated light/room state back afterwards. Apple Home writes are routed through mcp_homekit_commands in Supabase and applied by the Lightweave app with HomeKit access. Direct Hue/Nanoleaf bridges still need to be paired once on a computer for local-network control.

Publish

npm run build
npm publish --access public