Introducing the Aqara MCP Server

I. What is MCP?

MCP (Model - Context - Protocol) is an open - source protocol that enables AI systems like Claude to securely connect to a wide range of data sources. Leveraging a client - server architecture, it provides AI assistants with a universal standard for accessing external data, tools, and prompts. MCP supports both local and remote communication, and boasts features such as standardization and interoperability. It finds applications in development, enterprise automation, and other scenarios. Being open - source, its ecosystem is constantly growing.

II. The Aqara MCP Server

Overview

The Aqara MCP Server focuses on building a smart home control center. It allows for precise control of devices such as lights and air conditioners, and enables real-time accessing of device status, logs, and quantities. It also allows effortless activation and coordination of scenes, alongside flexible management across your entire Aqara app. It reshapes the smart home experience through minimalist interaction. Check the video to see our demonstration.

Introduction to Aqara MCP Tools

Functions Description Input Examples
Device Control Enables control of devices within the account, including lights, air conditioners, curtains, etc. Turn on the bedroom light. Turn off all the lights at home. Set the living room air conditioner to 25 degrees.
Scene Triggering Triggers the specified scene Run the Evening scene. Execute the Good Night scene in the bedroom. Execute the Reading scene in the study.
Automation Configuration Create automations with a single sentence. Currently, it mainly supports device control commands related to timing and delay. Open the bedroom curtains at 7 am tomorrow Turn off the air conditioner in 1 hour. Turn off all the lights at home in 3 hours.
Device Inquiry Reports the type, quantity, and status of devices in the home What lights are there at home? What devices are in the bedroom? Which lights at home are currently on?
Device Log Check Obtains the historical information of devices Check the operation records of the bedroom air conditioner this week. Check the operation history of the main living room light in the past three days. Find out when the brightness of the bedroom light was adjusted in the past three days.
Device Status Check Obtains the current status information of devices, such as checking the color, brightness, on/off status, etc. Is the bedroom light on?
Scene List Retrieval Obtains all scene data under the user’s home or checks the scenes in the specified room What scenes are there in the living room?
Home List Retrieval Obtains all homes under the user’s account What homes are under my account?
Home Switching Switches the home on voice command Switch home

III. Multilingual Support

Aqara MCP Server mainly supports the following languages: Chinese, English, German, French, Spanish, Russian, Japanese, Polish, Korean, Turkish, Czech, Slovak, Italian, Dutch, Hungarian, Greek, and Arabic.

IV. Quick Start

Would like to learn more? Check the following link!

We hope you love it! Your experience helps everyone. Share your review and let us know what you think—we’d love to hear what you’re enjoying or any ideas you have.

27 Likes

Amazing :heart_eyes: great work!!!

7 Likes

Keep up the good work

3 Likes

Would love to see a tutorial for ChatGPT since it’s widely used.

Good idea, please continue, I wish you good luck.

1 Like

This is a brilliant advancement, but I won’t how vulnerable the system becomes if you use the online approach - that is, could a home become vulnerable to being unlocked accidentally or by an outsider? I realise the MCP has security built into it, but still…

1 Like

Does it work with Google Gemini?

You can self host it.

Yes, it supports Google Gemini. For configuration guidance, refer to the detailed instructions on GitHub. If you encounter any issues or have specific questions, feel free to reach out to us for assistance.

I apologize in advance, I’m not experienced in this, but what’s the difference if I add the device to Google Home and the MCP solution, both will be able to control Gemini, right?

If necessary, please connect your device to the Aqara account first, and then use the MCP tool to control your device.

Nice, I love it!

1 Like

Check out Warp… It’s ideal for this kind of thing. It’s an LLM powered “agentic” shell. One subscription gives you access to all the OpenAI models, Anthropic, and others. And has integrated MCP, so it’s ready to roll. Feels pretty magical if you’re used to working in the shell.

1 Like

Thanks for sharing.

1 Like

Genial solution and idea.
Amazing integration with Ai Claude.
The best Ai available now Better as Chat Gbt 5

2 Likes

Good day.

I’m missing a lot of details on how to implement this MCP Server.
I have purchased a Awara Led Bulb to test this MCP using Claude Desktop but I have zero ways to move forward.

Questions:

  1. In terms of devices, do I need a M3 or any other device? Please describe the requirements in details.
  2. In the claude_desktop_config.json, what do you mean by “/path/to/aqara-mcp-server”? Do you have a real patch example? Do I need to point to a path only or to a file?

Thanks for your support. Let me help you resolve these issues:

  1. There are no specific devices required; the only requirement is that you have registered an Aqara Home account.
  2. The “/path/to/aqara-mcp-server” refers to the absolute path of the aqara-mcp-server executable file on your PC.
    For example, if I saved the aqara-mcp-server in the project folder, the path should be written as:
    /Users/*****/projects/aqara-mcp-server

Feel free to ask me if you have any questions.

1 Like

Thank you Lisan al Gaib.

The problem was in the build command. The original command is:

go build -ldflags="-s -w" -o aqara-mcp-server

But, for Windows users, the output should include an extension. So, this worked:

go build -ldflags="-s -w" -o aqara-mcp-server.exe

Now Claude Desktop can recognize the MCP Server however it is not finding my Aqara smart devices. I have purchased for tests and demonstration purposes two devices: A Hub M3 and a Smart LED Light Bulb T2 E26. My Windows computer with Claude Desktop and Aqara Hub and light are all in the same wifi. My API Key looks correct but I’m not quite confident how this API Key exactly knows my list of devices. So, I’m stuck now and there is zero documentation about that.