MCPgee
MCPgee
MCPgeeMCPgee

Aqara MCP

v1.0.0•Cloud Services•stable

Aqara's official MCP Server

aqaramcpai-integration
Share:
33
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Aqara MCP?

Aqara MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to aqara's official mcp server

Aqara's official MCP Server

This server falls under the Cloud Services and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Aqara's official MCP Server

Use Cases

Control Aqara smart home devices via MCP.
Manage IoT devices and automation.
Integrate Aqara ecosystem into AI workflows.
aqara

Maintainer

LicenseMIT
Languagego
Versionv1.0.0
UpdatedMay 9, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx aqara

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Aqara MCP

The Aqara MCP Server is Aqara's official remote MCP endpoint that lets AI assistants control your entire Aqara smart home ecosystem through natural language. It connects directly to Aqara's cloud at https://agent.aqara.com/open/mcp, exposing tools for querying device status, controlling lights and air conditioners, running scenes, managing automations, and monitoring energy consumption. Anyone who has Aqara smart home devices and wants to control them conversationally — asking an AI to dim the bedroom light or set all ACs to 24 degrees — can connect any MCP-compatible client in minutes without installing any local software.

Prerequisites

  • An Aqara account with devices already set up in the Aqara Home app
  • An Aqara API key (Bearer token) obtained from https://agent.aqara.com/login
  • An MCP client that supports HTTP or Streamable HTTP transport (e.g., Cursor, Claude Desktop with HTTP MCP support, or any MCP-compatible agent)
  • Internet access to reach https://agent.aqara.com/open/mcp
1

Create an Aqara developer account and get your API key

Navigate to https://agent.aqara.com/login and log in with your Aqara credentials. Once authenticated, generate an API key (Bearer token) from the developer portal. Keep this token secure — it grants full control of your smart home devices.

2

Choose your MCP client and open its configuration

Open the MCP server configuration file for your client. For Cursor this is .cursor/mcp.json; for Claude Desktop it is claude_desktop_config.json. The Aqara MCP server uses HTTP transport, so your client must support that transport type.

3

Add the Aqara MCP server configuration

Insert the Aqara server block into your MCP configuration, replacing YOUR_AQARA_API_KEY with the Bearer token you obtained from the Aqara developer portal.

{
  "mcpServers": {
    "aqara": {
      "type": "http",
      "url": "https://agent.aqara.com/open/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AQARA_API_KEY"
      }
    }
  }
}
4

Restart your MCP client

Save the configuration file and restart your MCP client (e.g., close and reopen Claude Desktop or reload Cursor) so it picks up the new server definition.

5

Verify the connection

Ask your AI assistant to list your homes or devices. A successful response confirms that authentication is working and the MCP server is reachable.

Aqara MCP Examples

Client configuration (Cursor / HTTP transport)

Add this block to your .cursor/mcp.json or equivalent MCP client configuration file, substituting your real API key.

{
  "mcpServers": {
    "aqara": {
      "type": "http",
      "url": "https://agent.aqara.com/open/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AQARA_API_KEY"
      }
    }
  }
}

Prompts to try

Once connected, use natural language to control your Aqara smart home devices.

- "Show me all devices in my home and their current status."
- "Turn on the living room lights and set brightness to 70%."
- "Set all air conditioners to 24 degrees cooling mode."
- "Run the Movie Night scene."
- "Show me the energy consumption for my home this week."
- "Check if there are any firmware updates available for my devices."

Troubleshooting Aqara MCP

Authentication error or 401 Unauthorized response

Double-check that your API key is correct and has not expired. The Authorization header value must be exactly 'Bearer YOUR_API_KEY' (with the word Bearer followed by a space). Regenerate the token from https://agent.aqara.com/login if necessary.

MCP client cannot connect or shows the server as offline

Confirm your MCP client supports HTTP or Streamable HTTP transport — stdio-only clients will not work with a remote HTTP endpoint. Verify the URL is https://agent.aqara.com/open/mcp (including the /open/mcp path). Check your internet connection.

Devices appear in the list but control commands have no effect

Ensure the Aqara Home app shows the devices as online and reachable from the cloud. Devices that are offline or on a local-only network cannot be controlled via the cloud API. Check device connectivity in the Aqara Home app.

Frequently Asked Questions about Aqara MCP

What is Aqara MCP?

Aqara MCP is a Model Context Protocol (MCP) server that aqara's official mcp server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Aqara MCP?

Follow the installation instructions on the Aqara MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Aqara MCP?

Aqara MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Aqara MCP free to use?

Yes, Aqara MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Aqara MCP Alternatives — Similar Cloud Services Servers

Looking for alternatives to Aqara MCP? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.

Open WebUI

★ 138.2k

User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

Anything LLM

★ 60.4k

The all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.

LocalAI

★ 46.4k

LocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.

Nacos

★ 33.0k

an easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.

Xiaozhi ESP32

★ 26.7k

本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.

Gateway

★ 11.8k

A blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Cloud ServicesAPIsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "aqara": { "command": "npx", "args": ["-y", "aqara"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Aqara MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides