Skip to main content
Glama
Sign In
enesjakozh

Govee MCP Server

by mathd
GitHub
Python
MIT License
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • The server uses .env files to store configuration variables including the Govee API key, device ID, and SKU.

  • The server uses pytest for running tests, including server tests with mocked API calls and CLI tests with real API calls.

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:

GOVEE_API_KEY=your_api_key_here GOVEE_DEVICE_ID=your_device_id_here GOVEE_SKU=your_device_sku_here

To get these values:

  1. Get your API key from the Govee Developer Portal
  2. 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:

npx -y @smithery/cli install @mathd/govee_mcp_server --client claude

Manual Installation

# Install with pip pip install . # For development (includes test dependencies) pip install -e ".[test]"

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:

# Turn device on/off govee-cli power on govee-cli power off # Set color using RGB values (0-255) govee-cli color 255 0 0 # Red govee-cli color 0 255 0 # Green govee-cli color 0 0 255 # Blue # Set brightness (0-100) govee-cli brightness 50

Run govee-cli --help for full command documentation.

Development

Running Tests

To run the test suite:

# Install test dependencies pip install -e ".[test]" # Run all tests pytest tests/ # Run specific test files pytest tests/test_server.py # Server tests (mocked API calls) pytest tests/test_cli.py # CLI tests (real API calls) # Run tests with verbose output pytest tests/ -v

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

. ├── src/govee_mcp_server/ │ ├── __init__.py │ ├── server.py # MCP server implementation │ └── cli.py # Command-line interface ├── tests/ │ ├── test_server.py # Server tests (with mocked API) │ └── test_cli.py # CLI tests (real API calls) └── pyproject.toml # Project configuration

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.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables users to control Govee LED devices using the Govee API, with features for turning devices on/off, setting colors, and adjusting brightness through a CLI or MCP clients.

  1. Setup
    1. Environment Variables
  2. Installation
    1. Installing via Smithery
    2. Manual Installation
  3. Usage
    1. MCP Server
    2. Command Line Interface
  4. Development
    1. Running Tests
    2. Project Structure
    3. Test Coverage

Related Resources

Related MCP Servers

  • HomeAssistant MCP

    jango-blockchained
    -
    security
    A
    license
    -
    quality
    Smart Device Control 🎮 💡 Lights: Brightness, color, RGB 🌡️ Climate: Temperature, HVAC, humidity 🚪 Covers: Position and tilt 🔌 Switches: On/off 🚨 Sensors: State monitoring Intelligent Organization 🏠 Grouping with context awareness. Robust Architecture 🛠️ Error handling, state validation ...
    Last updated -
    6
    9
    TypeScript
    Apache 2.0
    • Linux
    • Apple

  • OpenHue MCP Server

    lsemenenko
    A
    security
    A
    license
    A
    quality
    Enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.
    Last updated -
    6
    5
    TypeScript
    MIT License
    • Apple
    • Linux

  • SwitchBot MCP Server

    genm
    A
    security
    A
    license
    A
    quality
    Enables AI assistants to control SwitchBot devices, providing functionalities like device management, scene execution, and sensor information monitoring through the SwitchBot API.
    Last updated -
    3
    JavaScript
    ISC License

  • Lightdash MCP Server

    syucream
    A
    security
    A
    license
    A
    quality
    MCP-compatible server that enables AI assistants to interact with Lightdash analytics data, providing tools to list and retrieve projects, spaces, charts, dashboards, and metrics through a standardized interface.
    Last updated -
    13
    419
    10
    JavaScript
    MIT License

View all related MCP servers

Appeared in Searches

New MCP Servers

ID: 9pxau1w6vo