govee.com
govee.com logo

Govee

Integrates with Govee smart lighting devices to enable natural language control of brightness, color, and power settings...

Created byApr 23, 2025

Govee MCP Server

[![smithery badge](https://smithery.ai/badge/@mathd/govee_mcp_server)](https://smithery.ai/server/@mathd/govee_mcp_server)
An MCP server for controlling Govee LED devices through the Govee API.

Setup

Environment Variables

Create a `.env` file in the root directory with the following variables:
To get these values:
  1. Get your API key from the Govee Developer Portal
  1. Use the Govee Home app to find your device ID and SKU

Installation

Installing via Smithery

To install Govee MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@mathd/govee_mcp_server):

Manual Installation

Usage

MCP Server

The MCP server provides tools for controlling Govee devices through the Model Context Protocol. It can be used with Cline or other MCP clients.
Available tools:
  • `turn_on_off`: Turn the LED on or off
  • `set_color`: Set the LED color using RGB values
  • `set_brightness`: Set the LED brightness level

Command Line Interface

A CLI is provided for direct control of Govee devices:
Run `govee-cli --help` for full command documentation.

Development

Running Tests

To run the test suite:
Note: The CLI tests make real API calls to your Govee device and will actually control it. Make sure your device is powered and connected before running these tests.

Project Structure

Test Coverage

  • Server tests cover: - Environment initialization - Govee API client methods - Server tools and utilities - Error handling
  • CLI tests perform real-world integration testing by executing actual API calls to control your Govee device.