Overview
What is Aqara MCP Server?
Aqara MCP Server is a remote MCP service provided by Aqara Agent that allows MCP-enabled AI applications to securely connect to Aqara smart home capabilities, enabling query and control of homes, devices, scenes, automations, energy consumption, lighting effects, and firmware.
How to use Aqara MCP Server?
Obtain credentials from the Aqara Agent login page (https://agent.aqara.com/login) to get your aqara_api_key and aqara_mcp_url. Then configure your MCP host (e.g., Cursor or Codex App) to connect via Streamable HTTP to https://agent.aqara.com/open/mcp with a Bearer token using the aqara_api_key. After configuration, verify by sending natural-language requests such as "Show all devices in my home."
Key features of Aqara MCP Server
- Query home and room/space information.
- Query device basics, real-time status, and control logs.
- Control device attributes like power, brightness, temperature, and mode.
- Query and run smart scenes; review scene execution history.
- Query automation rules and their execution history.
- Query electricity usage and cost by room/space or device.
- Query and apply lighting effects; configure effect parameters.
- Query device firmware versions and start firmware upgrades.
Use cases of Aqara MCP Server
- Control lights, switches, outlets, air conditioners, window coverings, and cameras via AI assistants.
- Run "movie night" or other smart scenes from natural-language commands.
- Monitor energy consumption trends in specific rooms or for individual devices.
- Query automation rule execution history for home management.
- Batch-control all devices in a room (e.g., "turn off all lights in the living room").
