Harmonyos MCP Server

npm: https://www.npmjs.com/package/mcp-harmonyos A Model Context Protocol (MCP) server for HarmonyOS development. This server enables AI assistants like Claude to interact with HarmonyOS projects, devices, and applications. Its 7 documented tools cover harmonyos, info. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-25 · ★ 2 · #482 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Harmonyos

Claude Code

claude mcp add fadinglight9291117-mcp-harmonyos -- npx -y mcp-harmonyos

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "fadinglight9291117-mcp-harmonyos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-harmonyos"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package mcp-harmonyos - unscoped; check the name against the project README before installing

registry namespace io.github.FadingLight9291117 is GitHub-verified and matches the repo owner

03 · What Harmonyos can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all connected HarmonyOS devices, get detailed information about a specific device, list all modules in a project with their types (HAP/HSP/HAR), and check if build outputs exist and list them.

The 7 tools it gives your agent

Extracted from the project's README - what harmonyos lets an agent do.

harmonyos_list_devices: - List all connected HarmonyOS devices.
harmonyos_get_device_info: - Get detailed information about a specific device.
harmonyos_get_project_info: - Get HarmonyOS project information from app.json5.
harmonyos_list_modules: - List all modules in a project with their types (HAP/HSP/HAR).
harmonyos_check_build_outputs: - Check if build outputs exist and list them.
harmonyos_list_installed_apps: - List all installed applications on a device.
harmonyos_get_app_info: - Get detailed information about an installed application.

Latest releases

v1.1.0 · 2026-06-13

Release v1.1.0 · This release backports security and feature improvements from the vscode-arkts extension, doubling the toolset and hardening the hdc call layer. · New Tools (4) · Closing the build → install → launch →…

v1.0.4 · 2026-02-16

Release v1.0.4 · Changes · Updated publishing checklist and guides · Modularized server and tools structure for better maintainability · Updated smithery.yaml for MCP Registry publication · Installation · bash · npm…

v1.0.0 · 2026-02-15

First release of HarmonyOS MCP Server · 7 MCP tools for HarmonyOS development · Device management: list_devices, get_device_info · Project information: get_project_info, list_modules, check_build_outputs · Application…

04 · Who maintains Harmonyos

harmonyos is maintained by fadinglight9291117. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/fadinglight9291117/mcp-harmonyos
category: other - ranked #482 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-06-13)
registry: io.github.FadingLight9291117/harmonyos (active, first published 2026-02-15)
packages: npm:mcp-harmonyos

06 · Harmonyos FAQ

Is Harmonyos still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-25 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Harmonyos do?

How do I install Harmonyos?

Run `npx -y mcp-harmonyos`. You can also paste the ready-made client config above.

Does Harmonyos run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Harmonyos

Alternatives to Harmonyos

Maintained other servers if Harmonyos isn't the fit.

More MCP servers to compare · ParaView MCP Server · u-he Preset Randomizer · Aurora · Fastalertnow MCP Server · Open SCAD

More TypeScript MCP servers · BoondManager MCP Server · Feedthrough · see all