What is the Philips Hue MCP Server?

The Philips Hue MCP Server is a software that allows AI models, like Claude, to control Philips Hue lights using natural language. It leverages the Model Context Protocol (MCP) to provide a standardized interface for AI to interact with your lighting system.

What is MCP (Model Context Protocol)?

MCP is an open protocol that standardizes how applications provide context to LLMs. In this case, it allows the AI to understand and control the Philips Hue lights.

What are the benefits of using the Philips Hue MCP Server?

The benefits include natural language control of your lights, integration with AI assistants, the ability to create custom lighting scenes, improved energy efficiency, and enhanced accessibility.

What do I need to use the Philips Hue MCP Server?

You need Python 3.9+, a Philips Hue bridge connected to your local network, and Philips Hue lights paired with your bridge. You also need to install the phue and mcp Python packages.

How do I install the Philips Hue MCP Server?

1. Clone the repository or download the hue_server.py file.
2. Install the required dependencies: pip install phue mcp
3. Run the server: python hue_server.py
4. When prompted, press the link button on your Hue bridge to authorize the connection.

How do I integrate the server with Claude?

You can install it in Claude Desktop using mcp install hue_server.py --name "Philips Hue Controller" or test with the MCP Inspector using mcp dev hue_server.py.

How do I control my lights with Claude after installation?

Start with a prompt like: “I’d like to control my Philips Hue lights. Can you show me which lights I have available?”

Can I control multiple lights at once?

Yes, you can create and manage light groups to control multiple lights simultaneously.

Can I create custom lighting scenes?

Yes, you can create custom scenes tailored to your specific needs and recall them instantly.

Is the connection secure?

Yes, the server connects directly to your Hue bridge on the local network, ensuring secure and private communication.

What is UBOS?

UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. Our platform helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model and Multi-Agent Systems.

What if my Hue Bridge is not found?

If automatic discovery doesn’t work, manually edit the BRIDGE_IP variable in the script or manually create a config file with your bridge’s IP address in ~/.hue-mcp/config.json.

What if light control is not working?

Use the refresh_lights tool to update the light information cache.

Where can I find the server configuration file?

The configuration file is located at ~/.hue-mcp/config.json.