Overview
What is Govee MCP Server?
An MCP server for controlling Govee LED devices through the Govee API. It provides both an MCP tool interface for clients like Cline and a standalone command‑line interface for direct control.
How to use Govee MCP Server?
Set up three environment variables (GOVEE_API_KEY, GOVEE_DEVICE_ID, GOVEE_SKU) in a .env file. Install via Smithery (npx -y @smithery/cli install @mathd/govee_mcp_server) or manually with pip install .. Then use the MCP server’s tools (turn_on_off, set_color, set_brightness) or the CLI commands (govee-cli power, govee-cli color, govee-cli brightness).
Key features of Govee MCP Server
- Turn Govee LEDs on or off via MCP tool or CLI
- Set LED color using RGB values (0–255)
- Set LED brightness level (0–100)
- Works with MCP clients such as Cline and Claude Desktop
- Installable automatically via Smithery or manually with pip
- CLI provides direct terminal control without an MCP client
Use cases of Govee MCP Server
- Control Govee smart lights from an MCP‑aware AI assistant like Claude Desktop
- Script light changes (power, color, brightness) from the command line
- Integrate Govee lighting into automated workflows or home‑automation pipelines
- Test or debug Govee device interactions using the CLI with real API calls
FAQ from Govee MCP Server
How do I get my API key and device ID?
Get your API key from the Govee Developer Portal, then use the Govee Home app to find your device ID and SKU.
What MCP tools does the server provide?
It provides three tools: turn_on_off (power), set_color (RGB), and set_brightness (0–100).
Can I control the lights from the terminal without an MCP client?
Yes. The installed CLI offers commands govee-cli power, govee-cli color, and govee-cli brightness for direct control.
What environment variables are required?
You must set GOVEE_API_KEY, GOVEE_DEVICE_ID, and GOVEE_SKU in a .env file or environment.
How is the server installed?
You can install it automatically using Smithery (npx -y @smithery/cli install @mathd/govee_mcp_server) or manually with pip install . from the source directory.
