Govee MCP Server

LAN-first, cloud-fallback MCP server for Govee smart lights and devices.

Local serverstdioPython

What is the Govee MCP Server?

LAN-first, cloud-fallback MCP server for Govee smart lights and devices.

The short version

A LAN-first, cloud-fallback Model Context Protocol (MCP) server for Govee smart devices. Point an AI agent, or any MCP client, at your Govee lights, plugs, and appliances and control them by name.

  • Discovers your devices (cloud account list plus a LAN scan) and addresses them by friendly name
  • Controls power, brightness, RGB color, and white color temperature
  • Reads current device state (power, brightness, color)
  • Lists and applies dynamic scenes (preset effects), fetched live per device (cloud-only)
  • Groups devices so one command (on/off, color, scene, state) applies to every member
  • Prefers LAN for LAN-capable lights and falls back to the cloud for everything else

What it needs from you

  • Python 3.10 or newer. - A Govee API key for cloud control (optional, but needed for plugs, appliances, and non-LAN devices). Get one in the Govee Home app: Profile, then About Us, then Apply for API Key. - For LAN control: enable "LAN Control" on each device in the Govee Home app, and make sure UDP ports 4001, 4002, and 4003 can pass on your network.

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.

How to install the Govee MCP Server

{
  "mcpServers": {
    "govee": {
      "command": "govee-mcp",
      "env": { "GOVEE_API_KEY": "your-key-here" }
    }
  }
}

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

Configuration

  • Python 3.10 or newer. - A Govee API key for cloud control (optional, but needed for plugs, appliances, and non-LAN devices). Get one in the Govee Home app: Profile, then About Us, then Apply for API Key. - For LAN control: enable "LAN Control" on each device in the Govee Home app, and make sure UDP ports 4001, 4002, and 4003 can pass on your network.
VariableDescriptionRequired
GOVEE_API_KEYCredential the server authenticates with.Yes
PYTHONPATHPython module search path for a local installation.Optional
GOVEE_CACHE_PATHFilesystem location the server is allowed to use.Optional
GOVEE_GROUPS_PATHFilesystem location the server is allowed to use.Optional

Frequently asked questions

LAN-first, cloud-fallback MCP server for Govee smart lights and devices. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.