Nanoleaf MCP Server

Nanoleaf MCP Server is an MCP server that connects Model Context Protocol clients directly to Nanoleaf smart lighting setups over a local network. Built for smart home enthusiasts and developers using AI-enabled terminals like Warp, it enables natural language and tool-based control over smart panels such as Nanoleaf Canvas, Light Panels, and Hexagons. Users can discover compatible devices on their local subnet, request pairing authorization tokens, and query current hardware state. Once configured, the server allows automated adjustment of light panel properties including power status, brightness levels, and custom color settings defined by hue and saturation. It also exposes tools to list available dynamic lighting scenes and activate specific preset animations, such as Northern Lights or Cyberpunk, directly from an LLM prompt. By packaging the Nanoleaf v1 API into a Dockerized MCP environment, this server provides a bridge between local IoT devices and AI assistants without relying on third-party cloud bridges.

Category: Cloud & Infrastructure

Tags: iot, lighting, nanoleaf, smart-home

Visit Nanoleaf MCP Server

How to install and configure Nanoleaf MCP Server

1. Clone the repository and build the Docker image: bash git clone https://github.com/srnetadmin/nanoleaf-mcp-server cd nanoleaf-mcp-server docker build -t nanoleaf-mcp-server-nanoleaf-mcp-server . 2. Put your Nanoleaf device into pairing mode by holding its power button for 5-7 seconds, then request an authentication token: bash curl -X POST http://<DEVICE_IP>:16021/api/v1/new 3. Add the server to your Warp MCP configuration: json { "mcpServers": { "nanoleaf": { "command": "docker", "args": [ "run", "--rm", "-i", "--network=host", "-e", "NANOLEAF_IP=<DEVICE_IP>", "-e", "NANOLEAF_AUTH_TOKEN=<AUTH_TOKEN>", "-e", "NANOLEAF_PORT=16021", "-e", "NANOLEAF_PROTOCOL=http", "nanoleaf-mcp-server-nanoleaf-mcp-server" ], "env": {} } } }

What you can do with Nanoleaf MCP Server

• Turn Nanoleaf panels on or off using natural language prompts within your MCP client environment. * Adjust brightness levels and fine-tune panel colors using hue and saturation commands. * Discover compatible Nanoleaf hardware and inspect current hardware configurations across local subnets. * List and trigger animated lighting effects like Northern Lights directly during terminal sessions.

Key facts

• https://github.com/srnetadmin/nanoleaf-mcp-server
• Cloud & Infrastructure, Other & General Purpose
• iot, lighting, nanoleaf, smart-home

Part of MCP Servers

What can Nanoleaf MCP Server do?

Nanoleaf MCP Server enables AI clients to manage Nanoleaf smart lights. It provides tools to scan local networks, request pairing tokens, turn panels on or off, adjust brightness, set color hues and saturation, and switch between dynamic lighting effects.

How do I install Nanoleaf MCP Server?

You install the server by cloning its GitHub repository and building the provided Docker container. You can also run the included automated setup script, which builds the image, scans your network for devices, acquires an authorization token, and configures the environment.

Which MCP clients work with Nanoleaf MCP Server?

Nanoleaf MCP Server is explicitly documented and tested for integration with Warp terminal, but it works with any Model Context Protocol compliant client capable of running local Docker commands over standard input and output.

Is Nanoleaf MCP Server open source?

Yes, Nanoleaf MCP Server is open-source software released under the MIT License, and the source code is hosted on GitHub.