Nanoleaf

Provides MCP-based control for Nanoleaf devices with discovery, authorization, and full lighting controls.

typescript

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "srnetadmin-nanoleaf-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--network=host",
        "-e",
        "NANOLEAF_IP=192.168.1.100",
        "-e",
        "NANOLEAF_AUTH_TOKEN=YourAuthTokenHere123456789",
        "-e",
        "NANOLEAF_PORT=16021",
        "-e",
        "NANOLEAF_PROTOCOL=http",
        "nanoleaf-mcp-server-nanoleaf-mcp-server"
      ],
      "env": {
        "NANOLEAF_IP": "192.168.1.100",
        "NANOLEAF_PORT": "16021",
        "NANOLEAF_PROTOCOL": "http",
        "NANOLEAF_AUTH_TOKEN": "YourAuthTokenHere123456789"
      }
    }
  }
}

You run an MCP server to control Nanoleaf lights from any MCP-compatible client or Warp terminal. This server lets you auto-discover devices, securely authorize pairing, and send full lighting commands like turning lights on, adjusting brightness, changing colors, and applying effects, all through a Dockerized, easy-to-deploy setup.

How to use

Connect to Nanoleaf devices using the MCP client of your choice. You will choose either a local (stdio) approach that runs the server inside Docker, or a Bash-based approach that executes a Docker run through a shell command. Once the server is running, you can perform actions such as turning the lights on or off, adjusting brightness, changing colors, and applying lighting effects. Use the provided tools to query device information, discover devices on the network, authorize pairing, and manage connections to specific IPs.

How to install

Prerequisites you need before starting:

• Docker installed on your system

• Nanoleaf device(s) on your network

• Warp terminal (optional, for MCP integration)

Step by step you can follow these commands to set up and run the Nanoleaf MCP server.

Build the Docker image and prepare for running the server.
Obtain the authorization token by placing the Nanoleaf in pairing mode and issuing the auth token request.
Create an environment file with your device IP, auth token, port, and protocol.
Run the server using the Docker-based configuration described in the sections below.

Additional sections

Configuration and usage details are provided through explicit config examples and practical steps to operate the Nanoleaf MCP server.

Notes and examples

The server supports auto-discovery, direct IP connections, and authorization for secure pairing. It is Dockerized for easy deployment and integrates with Warp terminal. You can list all supported actions, discover devices, authorize, and then control power, brightness, color, and effects.

Available tools

get_nanoleaf_info

Retrieve detailed information about the connected Nanoleaf device.

turn_on_nanoleaf

Power on the Nanoleaf device.

turn_off_nanoleaf

Power off the Nanoleaf device.

set_brightness

Adjust brightness from 0 to 100.

set_color

Set hue (0-360) and saturation (0-100) for color changes.

set_effect

Apply a lighting effect to the device.

get_effects

List all available lighting effects.

discover_nanoleaf

Discover Nanoleaf devices on the local network.

connect_to_ip

Connect to a Nanoleaf device by IP address.

authorize_nanoleaf

Authorize with a device when it is in pairing mode.

Built by

VeilStrat

AI signals for GTM teams