BHL + GROK
Connect BHL WLED Lights to Grok
Use Grok to control compatible WLED and permanent lights connected to your Bright Home Lights cloud account. Follow the setup steps, enable AI access, and try a lighting request.
Before you start
Your BHL account, connected
Have your existing BHL account and a signed-in Grok account ready. In the BHL app, review which devices are enabled for AI access. Saving access settings alone does not connect Grok.
Open Grok connectors
Open grok.com/connectors in your browser. Choose New Connector, then Custom.
Using a Business or Enterprise team? Complete the team-admin step below first.
Add Bright Home Lights
Name the connector Bright Home Lights. Enter this MCP server URL:
https://mcp.brighthomelights.com/mcpContinue with the connection prompts. Copy the full URL, including the final /mcp.
Sign in to your BHL account
When the BHL sign-in page opens, use the account that holds your lights. Review the permissions and complete the consent flow, then return to Grok.
Check your devices
Start a conversation in Grok and ask:
List my Bright Home Lights devices.
This first test reads device information without changing your lights. Compare the returned devices with the devices enabled for AI access in BHL.
Device availability returned by this list is cached; it is not a live connectivity measurement.
Business and Enterprise teams
A team admin must first open console.x.ai, select the team, and go to Grok Business → Connectors. Choose + Add Connector → Other, enter the BHL MCP server URL above and complete any required authentication. Team members then link their own BHL accounts in Grok.
Connection help
I cannot find the custom connector option
Check the current Grok connector interface. For a Business or Enterprise account, ask your team admin to provision the connector first.
My lights are missing
Confirm you linked the BHL account that owns the devices and that those devices are enabled for AI access. Saving access settings does not complete account linking; finish the Grok connection flow.
The connection does not finish
Check the server URL for typos and complete the BHL sign-in and consent prompts. If it still fails, contact BHL support with the error message, without sharing passwords or access tokens.
Is this an official Grok listing?
No. BHL connects through Grok’s custom MCP option. This guide does not describe a catalog listing or a pending directory approval.
Find the connection in the BHL app
Open Settings → Integrations → Grok. These Android app screens show the signed-out view; sign in to BHL to manage device and preset access.
What you can ask BHL to do
MCP connects your assistant to the BHL account, devices and presets you allow. Start with a device check, name the device in later requests, and review the proposed action before confirming a change—especially a permanent deletion.
Actions depend on account and device access, permissions and connectivity. These examples describe supported connector capabilities; they are not a claim that every command has been independently tested on every assistant. The assistant may ask you to clarify the device, preset or schedule.
Check your connection and lights
Check account connection
Check your BHL account connection and granted permissions.
Example: Is my Bright Home Lights account connected?
List your devices
List accessible cloud-provisioned devices, including online, offline or unknown status. Status is cached and may be delayed; an offline result does not explain the cause.
Example: List my lights and their online status.
Read current controller state
Request fresh power, brightness, active preset, effect and color information for a device.
Example: Check the current state of Patio Lights.
Browse saved presets
List saved presets visible to your account on a chosen device.
Example: Show my Studio presets.
Set lights and manage presets
Change your lights
Turn a device on or off; set brightness from 0–100%, one RGB color, a supported effect, or effect speed/intensity from 0–100%. Friendly styles include solid, breathe, blink, colorloop, chase, twinkle, rainbow and fireworks. Optional durations are 1–1,440 minutes with previous-state restore. Each device operation targets one device; changes to multiple devices are applied separately.
Example: Set Patio Lights blue at 40% for 10 minutes, then restore the previous lights.
Run a saved preset
Apply an existing preset to a chosen device, optionally for 1–1,440 minutes and then restore the previous state.
Example: Run Evening on Patio Lights for 30 minutes, then restore the previous lights.
Create a new preset
Create a new, non-overwriting preset with a 1–32 character name, one to three RGB colors, a supported style, brightness and supported effect settings. Saving briefly changes the lights to verify the result and normally restores the prior state. Confirm whether to leave the preview active. Arbitrary effects and pixel-by-pixel editing are not supported.
Example: Create a blue-and-gold twinkle preset called Game Night on Patio Lights; restore the previous lights afterward.
Delete a preset
Permanently delete an owner-controlled preset after confirming its exact name and device. A preset used by a schedule or sports automation cannot be deleted until that dependency is resolved.
Example: Help me delete Game Night from Patio Lights; confirm the exact preset before deleting.
Review and recover changes
Review recent activity
See recent AI lighting actions.
Example: Show my recent AI lighting activity.
Undo the latest AI change
Undo the latest still-active AI lighting change across your account, without overwriting newer unrelated changes.
Example: Undo my last AI lighting change.
Restore a device’s previous state
Restore a captured prior state for a chosen device and applicable action. This cannot recover an arbitrary historical moment.
Example: Restore the captured previous state of Patio Lights.
Cancel an automatic restore
Cancel a pending timed restore, normally leaving the current lighting unchanged. Request an immediate restore explicitly if desired.
Example: Cancel the pending restore on Patio Lights and keep the current lights.
Schedules and sports automations
View automations
List device schedules and sports automations, including whether each is enabled.
Example: Show my Patio Lights schedules and sports automations.
Find supported sports options
Discover currently supported sports, competitions, teams and event triggers before choosing a celebration.
Example: Which teams and sports events can trigger my lights?
Create a schedule or sports automation
Create recurring fixed-time schedules on selected weekdays using device-local time and an existing preset. Sports automations use supported team/event options and an existing preset, with auto-run or ask-first mode, a 1–60 minute duration and optional cooldown. Creating sunrise/sunset schedules is not supported, even if existing schedules show those types.
Example: Run Evening on Patio Lights at 7 PM every day. Confirm the device-local time before saving.
Edit an automation
Edit supported name, enabled state, preset, fixed time, weekdays, mode or duration fields. Changing a sports team or trigger requires deleting and recreating that automation.
Example: Change my Evening schedule to 8 PM on weekdays.
Pause or enable an automation
Enable or disable a schedule or sports automation without deleting it.
Example: Pause my Evening schedule.
Delete an automation
Permanently delete the exact confirmed schedule or sports automation.
Example: Help me delete the Evening schedule; confirm which one before deleting.
Test an automation
Apply the automation’s preset for one minute, then restore the prior lighting. This does not simulate a real sports event.
Example: Test my Patio Lights celebration for one minute, then restore the previous lights.
Need help connecting?
Tell us which setup step is not completing.
Permanent lighting and WLED compatibility
Control compatible WLED lights connected to your Bright Home Lights cloud account using natural language. Devices must be connected to your BHL cloud account and enabled for AI access. A standalone local WLED controller is not automatically accessible through the BHL MCP connector; support depends on the device and firmware. This connection does not provide arbitrary raw WLED commands.
For permanent Christmas lights, roofline lighting or everyday outdoor lighting, begin by checking which devices the assistant can access. Name the device in your request, then ask for a supported color, brightness or saved preset. Each device operation targets one device; changes to multiple devices are applied separately.
Need to prepare your controller? See controller Wi-Fi setup, WLED LED count and segments, and the Bright Home Lights app guide.