How do I install the hue ble mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `HUE_LIGHT_ADDRESS` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Hue BLE MCP Server

Control Philips Hue lights via Bluetooth LE — no bridge required.

Local serverstdioPython

What is the Hue BLE MCP Server?

Control Philips Hue lights via Bluetooth LE — no bridge required.

The short version

An MCP server that lets Claude control Philips Hue lights via Bluetooth LE — no Hue Bridge or internet connection required.

What it needs from you

macOS (uses CoreBluetooth via bleak) - Python 3.10+ - A Philips Hue light with Bluetooth support (most lights made after 2019) - Claude Desktop

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
scan_hue_lights	Discover nearby Hue BLE lights and get their addresses
turn_on	Turn a light on
turn_off	Turn a light off
set_brightness	Set brightness 1–100%
set_color_temperature	Set white color temperature (2000K warm → 6500K cool)
set_color	Set RGB color
get_light_state	Read current power, brightness, and color mode
set_scene	Apply a preset: relax, energize, concentrate, reading, nightlight, bright

How to install the Hue BLE MCP Server

{
  "mcpServers": {
    "hue-ble": {
      "command": "/absolute/path/to/hue-ble-mcp/venv/bin/python",
      "args": ["/absolute/path/to/hue-ble-mcp/server.py"],
      "env": {
        "HUE_LIGHT_ADDRESS": ""
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

macOS (uses CoreBluetooth via bleak) - Python 3.10+ - A Philips Hue light with Bluetooth support (most lights made after 2019) - Claude Desktop

Variable	Description	Required
HUE_LIGHT_ADDRESS	Configuration value read at startup.	Optional

Example prompts to try

“Use Hue BLE MCP to scan hue lights.”
“Use Hue BLE MCP to turn on.”
“Use Hue BLE MCP to turn off.”

Frequently asked questions

Control Philips Hue lights via Bluetooth LE — no bridge required. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Hue BLE MCP Server

Filesystem

Official

Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.

File Systems & StorageTypeScript★ 63.0k

Context7

Official

Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.

Documentation & API ReferencesRemoteTypeScript★ 32.0k

WildDatum

Agent-native ecological data discovery, analysis, visualization, and provenance

Developer Tools

Etherscan MCP Server

A Go implementation of an Etherscan API client for the Model Context Protocol (MCP) that enables LLM applications to access Etherscan blockchain data.

Blockchain & Web3

PassNinja

Issue and manage Apple Wallet & Google Wallet passes from any MCP-aware AI client.