Skip to main content
Glama

MCP Wyze Server

by aldilaff
GitHub
Python
MIT License
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Wyze Server

An MCP (Model Context Protocol) server for controlling Wyze smart home devices using the wyze-sdk library.

Overview

This MCP server provides a comprehensive interface for interacting with Wyze devices through AI assistants like Claude. It supports authentication, device discovery, device control, and group management for various Wyze smart home products.

Features

  • Authentication: Secure login using Wyze API credentials
  • Device Discovery: List and get information about all Wyze devices
  • Device Control: Turn devices on/off, adjust brightness, and more
  • Group Management: Control entire rooms or groups of devices at once
  • Live Resources: Real-time device and group status monitoring
  • Automatic Login: Uses environment variables for seamless authentication

Prerequisites

  • Python 3.13+
  • Wyze developer account with API credentials
  • uv package manager

Installation

uv pip install mcp-wyze-server

Or with pip:

pip install mcp-wyze-server

Option 2: Install from Source

  1. Clone the repository:
git clone https://github.com/aldilaff/mcp-wyze-server.git cd mcp-wyze-server
  1. Install with uv:
uv pip install -e .

Or build and install:

uv build uv pip install dist/*.whl

Configure Environment Variables

After installation, configure environment variables:

cp .env.example .env

Edit .env and add your Wyze credentials:

WYZE_EMAIL=your-email@example.com WYZE_PASSWORD=your-password WYZE_KEY_ID=your-key-id-here WYZE_API_KEY=your-api-key-here

Getting Wyze API Credentials

To obtain your Wyze API credentials:

  1. Visit the Wyze Developer Portal
  2. Create a developer account if you don't have one
  3. Create a new API key
  4. Note down your KEY_ID and API_KEY

Usage

Running the Server Standalone

If installed from PyPI:

mcp-wyze-server

If running from source:

uv run python src/mcp_wyze_server/server.py

Integrating with Claude Desktop

Add this configuration to your Claude Desktop MCP settings:

If installed globally via pip/uv:

{ "mcpServers": { "wyze": { "command": "/Users/{yourusername}/.local/bin/uv", "args": ["tool", "run", "mcp-wyze-server"], "env": { "WYZE_EMAIL": "your-email@example.com", "WYZE_PASSWORD": "your-password", "WYZE_KEY_ID": "your-key-id", "WYZE_API_KEY": "your-api-key" } } } }

Note: Replace /Users/yourusername/.local/bin/uv with the actual path to your uv installation. You can find this by running which uv in your terminal.

If running from source (recommended for development):

{ "mcpServers": { "wyze": { "command": "/Users/yourusername/.local/bin/uv", "args": [ "run", "--directory", "/path/to/mcp-wyze-server", "python", "src/mcp_wyze_server/server.py" ], "env": { "WYZE_EMAIL": "your-email@example.com", "WYZE_PASSWORD": "your-password", "WYZE_KEY_ID": "your-key-id", "WYZE_API_KEY": "your-api-key" } } } }

Note: Replace /Users/yourusername/.local/bin/uv with your actual uv path.

Configuration with Other MCP Clients

This server uses stdio transport and can be integrated with any MCP client that supports the protocol.

If installed via PyPI:

mcp-wyze-server

If running from source:

uv run python /path/to/mcp-wyze-server/src/mcp_wyze_server/server.py

Available MCP Tools

Authentication

  • wyze_login() - Login to Wyze account (uses env vars)

Device Management

  • wyze_get_devices() - List all devices
  • wyze_device_info(device_mac) - Get device details
  • wyze_get_device_status(device_mac) - Get accurate current status (power state, brightness, etc.)

Basic Device Control

  • wyze_turn_on_device(device_mac) - Turn on a device
  • wyze_turn_off_device(device_mac) - Turn off a device
  • wyze_set_brightness(device_mac, brightness) - Set brightness (0-100)

Enhanced Light Control

  • wyze_set_color_temp(device_mac, color_temp) - Set color temperature (2700K-6500K)
  • wyze_set_color(device_mac, color) - Set RGB color (hex format)
  • wyze_set_light_effect(device_mac, effect) - Set visual effects
  • wyze_set_light_sun_match(device_mac, enabled) - Enable/disable sun matching
  • wyze_clear_light_timer(device_mac) - Clear scheduled timers

Scale Management

  • wyze_get_scales() - List all Wyze scales
  • wyze_get_scale_info(device_mac) - Get detailed scale information
  • wyze_get_scale_records(device_mac, user_id, days_back) - Get weight/body composition records

Resources

  • wyze://devices - Live device list with status
  • wyze://scales - Live scale list with family members

Prompts

  • wyze_device_control_prompt(device_name, action) - Generate control prompts
  • wyze_scale_health_prompt(family_member_name, timeframe) - Generate health analysis prompts

Supported Devices

This server supports various Wyze device types including:

  • Lights (Bulbs, Light Strips)
  • Switches
  • Plugs
  • Scales
  • Locks
  • Cameras (basic control)
  • Thermostats
  • And more...

Development

This project uses:

  • FastMCP: A high-performance MCP server framework
  • wyze-sdk: Comprehensive Python interface for Wyze devices
  • uv: Fast Python package manager

Project Structure

mcp-wyze-server/ ├── src/ │ └── mcp_wyze_server/ │ ├── __init__.py │ └── server.py # MCP server implementation ├── test_device.py # Device testing utility ├── pyproject.toml # Project dependencies ├── .env.example # Environment variables template ├── CLAUDE.md # Development guidelines for Claude ├── LICENSE # MIT License └── README.md # This file

Troubleshooting

Common Issues

  1. Authentication Failed: Ensure your Wyze credentials are correct and API keys are valid
  2. Device Not Found: Device MAC addresses are case-sensitive
  3. Connection Timeout: Check your network connection and Wyze service status

Debug Mode

Enable debug logging by setting the environment variable:

export MCP_DEBUG=true

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Wyze SDK for the excellent Python library
  • MCP for the Model Context Protocol specification
  • FastMCP for the MCP server framework

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Wyze Labs, Inc. All product names, logos, and brands are property of their respective owners.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

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.

Tools

View all tools

Enables control and monitoring of Wyze smart home devices through AI assistants. Supports device discovery, control (on/off, brightness, color), group management, and health tracking for scales with real-time status monitoring.

  1. Overview
    1. Features
      1. Prerequisites
        1. Installation
          1. Option 1: Install from PyPI (Recommended)
          2. Option 2: Install from Source
          3. Configure Environment Variables
          4. Getting Wyze API Credentials
        2. Usage
          1. Running the Server Standalone
          2. Integrating with Claude Desktop
          3. Configuration with Other MCP Clients
        3. Available MCP Tools
          1. Authentication
          2. Device Management
          3. Basic Device Control
          4. Enhanced Light Control
          5. Scale Management
          6. Resources
          7. Prompts
        4. Supported Devices
          1. Development
            1. Project Structure
          2. Troubleshooting
            1. Common Issues
            2. Debug Mode
          3. Contributing
            1. License
              1. Acknowledgments
                1. Disclaimer

                  Related MCP Servers

                  • homeassistant-mcp

                    tevonsb
                    -
                    security
                    A
                    license
                    -
                    quality
                    Access Home Assistant data and control devices (lights, switches, thermostats, etc).
                    Last updated -
                    6
                    406
                    Apache 2.0

                  • 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
                    28
                    Apache 2.0
                    • Linux
                    • Apple

                  • Google Home MCP Server

                    jmagar
                    -
                    security
                    F
                    license
                    -
                    quality
                    Enables users to control Google Home smart plugs using the Smart Home API with OAuth2 authentication, offering real-time device state management and control operations.
                    Last updated -
                    1

                  • 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
                    ISC License

                  View all related MCP servers

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/aldilaff/mcp-wyze-server'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server