HarmonyOS MCP

How to Set Up and Use HarmonyOS MCP

The HarmonyOS MCP Server is a Python-based MCP integration that enables AI assistants to control and automate HarmonyOS-next devices connected via ADB (Android Debug Bridge), exposing device control and UI automation capabilities through the Model Context Protocol. It allows agents to launch applications, execute device commands, and drive UI interactions on Huawei HarmonyOS devices as if they had hands-on access. Developers building HarmonyOS apps who want AI-assisted testing and automation, or power users who want to control their HarmonyOS phone through natural language commands, will find this server bridges the gap between conversational AI and device control.

git clone https://github.com/XixianLiang/HarmonyOS-mcp-server.git
cd HarmonyOS-mcp-server

uv python install 3.13
uv sync

# Verify device connectivity (using hdc, Huawei's device connector tool)
hdc list targets

{
  "mcpServers": {
    "harmonyos": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/HarmonyOS-mcp-server",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

{
  "mcpServers": {
    "harmonyos": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/yourname/HarmonyOS-mcp-server",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

- "Launch the Settings app on the phone."
- "Open the Camera application on the connected HarmonyOS device."
- "Take a screenshot of the current screen on the device."
- "Navigate back to the home screen on the phone."
- "Launch the app with package name com.example.myapp on the connected device."