Harmonyos MCP Server

MCP server for HarmonyOS development - interact with projects, devices, and applications

Local serverstdioTypeScript

What is the Harmonyos MCP server?

If you already use Harmonyos, the harmonyos mcp server is the piece that lets your assistant work with it directly. MCP server for HarmonyOS development - interact with projects, devices, and applications.

What the server does

A Model Context Protocol (MCP) server for HarmonyOS development. This server enables AI assistants like Claude to interact with HarmonyOS projects, devices, and applications.

  • Device Management — List and query connected HarmonyOS devices
  • Project Information — Read project configuration, modules, and build outputs
  • Application Management — List and inspect installed applications on devices
  • Build Verification — Check build outputs and project structure

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • harmonyos_list_devices — The harmonyos_list_devices tool exposed by this server
  • harmonyos_get_device_info — The harmonyos_get_device_info tool exposed by this server
  • harmonyos_get_project_info — The harmonyos_get_project_info tool exposed by this server
  • harmonyos_list_modules — List all modules in a project with their types (HAP/HSP/HAR)
  • harmonyos_check_build_outputs — The harmonyos_check_build_outputs tool exposed by this server
  • harmonyos_list_installed_apps — The harmonyos_list_installed_apps tool exposed by this server
  • harmonyos_get_app_info — The harmonyos_get_app_info tool exposed by this server

Installation

mcp-harmonyos on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Credentials and setup notes

  • Node.js 18+ - HarmonyOS DevEco Studio (for hdc command-line tools) - hdc must be available in your PATH

Where it fits

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Harmonyos's toolset — harmonyos_list_devices, harmonyos_get_device_info, harmonyos_get_project_info and 4 more — is a fair guide to whether it matches your workflow. It is maintained by FadingLight9291117; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
harmonyos_list_devicesThe harmonyos_list_devices tool exposed by this server.
harmonyos_get_device_infoThe harmonyos_get_device_info tool exposed by this server.
harmonyos_get_project_infoThe harmonyos_get_project_info tool exposed by this server.
harmonyos_list_modulesList all modules in a project with their types (HAP/HSP/HAR).
harmonyos_check_build_outputsThe harmonyos_check_build_outputs tool exposed by this server.
harmonyos_list_installed_appsThe harmonyos_list_installed_apps tool exposed by this server.
harmonyos_get_app_infoThe harmonyos_get_app_info tool exposed by this server.

How to install the Harmonyos MCP server

{
  "mcpServers": {
    "harmonyos": {
      "command": "mcp-harmonyos"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 18+ - HarmonyOS DevEco Studio (for hdc command-line tools) - hdc must be available in your PATH

Example prompts to try

  • Use Harmonyos to harmonyos list devices.
  • Use Harmonyos to harmonyos get device info.
  • Use Harmonyos to harmonyos get project info.

Frequently asked questions

It connects Harmonyos to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (harmonyos_list_devices, harmonyos_get_device_info, harmonyos_get_project_info, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Harmonyos directly.