Aqara MCP Server

Aqara MCP Server

Control Aqara smart home devices, query status, execute scenes, and much more using natural language.

23
Stars
4
Forks
3
Releases

Overview

Aqara MCP Server is a smart home automation control service built on the Model Context Protocol (MCP). It acts as a bridge between AI assistants and the Aqara cloud, allowing commands from chat or voice interfaces to query device status, control devices, and manage scenes. The server supports core MCP tools for device control, device queries, scene management, home management, and automation configuration. It exposes a Go-based implementation that can run as a remote hosted service or as a local executable, enabling cross-platform deployment. Users authenticate via Aqara credentials retrieved from a login page to obtain api_key and base_url, ensuring secure communication. It provides multi-home support, so users can switch between homes, and supports scheduling or delaying tasks through automation_config. The architecture includes a modular server with tool registration, authentication middleware, and a wrapper over the Aqara Smart Home platform API. The server is designed to be easily extensible, with clear API references for integration with various MCP clients.

Details

Owner
aqara
Language
Go
License
MIT License
Updated
2025-12-07

Features

Comprehensive Device Control

Fine-grained control over device attributes such as on/off, brightness, color temperature, and modes.

Flexible Device Query

Query device lists and detailed statuses by room or device type.

Smart Scene Management

Query and execute user-defined scenes to automate smart home routines.

Device History

Query historical status change records within a specified time range.

Automation Configuration

Configure scheduled or delayed device control tasks.

Multi-Home Support

Query and switch between different homes under a user's account.

MCP Protocol Compatibility

Fully compliant with MCP specification for easy integration with AI assistants.

Secure Authentication

Login authorization and signature-based security to protect user data.

Audience

AI AssistantsBridge AI assistants (e.g., Claude, Cursor) with Aqara devices using MCP.
DevelopersDevelopers can run remote or local MCP server and extend features.
HomeownersHomeowners or integrators seeking secure, multi-home Aqara control and automation.

Tags

AqaraMCP ProtocolGoSmart HomeAI AssistantsHome AutomationDevice ControlScene ManagementMulti-HomeCloud APISecurity