Log inSubmit server
Matter Controller MCP logo

Matter Controller MCP

by 0x1abin

Controls, commissions, inspects, and configures Matter devices through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Matter Controller MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "0x1abin-matter-controller-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "matter-controller-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 11 tools correctly (1mo ago).

Overview

The 0x1abin/matter-controller-mcp MCP server lets AI clients commission, inspect, and control Matter devices through standardized MCP tools. It initializes a Matter controller at startup and supports device management, on/off control, dimming, color, and direct cluster attribute access. The package can run over stdio, SSE, or streamable HTTP, with optional BLE commissioning and environment-based configuration. Reach for it when an MCP client needs to operate Matter-compatible lights, switches, sensors, or other devices on a Matter network.

Use cases

  • Commission Matter devices through an AI assistant
  • Control lights, switches, and outlets
  • Adjust brightness and color settings
  • Read and write Matter cluster attributes
  • Inspect commissioned device capabilities

Key features

  • Matter device commissioning and decommissioning
  • On/off, dimming, and color controls
  • Device discovery and capability inspection
  • Cluster attribute reads and batch writes
  • stdio, SSE, and streamable HTTP transports
  • Optional BLE commissioning

Tools11

What Matter Controller MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

17/18 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · matter-controller-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
npm downloads82Package downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed11Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How Matter Controller MCP works

What 0x1abin/matter-controller-mcp MCP server does

The 0x1abin/matter-controller-mcp MCP server connects an MCP client to Matter-compatible devices. It exposes operations for commissioning and removing devices, checking controller state, listing commissioned nodes, and retrieving device details including their capability structure.

Device control covers common lighting and switching tasks. The available controls can change an on/off state, toggle a device, set a dimming level from 0 to 254, and set color temperature or hue and saturation. The server also supports lower-level Matter interaction through cluster attribute reads and writes, including reading selected attributes, reading every attribute in a cluster, and submitting multiple attribute values in one write.

Supported examples include on/off lights, dimmable lights, color lights, smart switches, outlets, and various sensors.

How it works

The MCP client communicates with the server, which acts as the intermediary to the Matter network. The controller is initialized automatically when the process starts. A client can then commission a device using a manual pairing code, an IP address with a setup PIN, or BLE commissioning with Wi-Fi credentials. Once commissioned, devices can be addressed by node ID.

Transport selection is available at startup. The default is stdio; sse starts the SSE transport, and streamableHttp starts the streamable HTTP transport. HTTP and SSE deployments can use the PORT setting to select a listening port. BLE commissioning may require operating-system permissions and a compatible BLE interface.

The reset_controller operation clears controller storage and requires confirmation, so it should be treated as a destructive administrative action.

Setup and configuration

The published npm package is matter-controller-mcp. The 0x1abin/matter-controller-mcp MCP server requires Node.js 18 or newer, and the project documentation also lists TypeScript 5.6 or newer and a Matter.js-compatible system for development or execution.

For MCP clients using stdio, the package can be launched with npx -y matter-controller-mcp. Cursor configuration can use the same command with matter-controller-mcp and stdio as arguments. Source installation instead involves cloning the repository, running npm install, and building with npm run build.

Configuration is environment-based. MATTER_UNIQUE_ID sets the controller identifier, MATTER_ADMIN_FABRIC_LABEL sets its administrative fabric label, and MATTER_LOG_LEVEL controls logging verbosity. BLE can be enabled with the documented ble setting and assigned an HCI interface with ble.hci.id; these names are shown in the README as lowercase environment variables. PORT selects the port for SSE or streamable HTTP operation. Debug logging uses MATTER_LOG_LEVEL=debug.

Tools and capabilities

The MCP tool set includes:

  • get_controller_status for controller state.
  • commission_device and decommission_device for Matter device lifecycle management.
  • get_commissioned_devices for listing nodes, with optional node ID filtering.
  • get_device_info for device and capability details.
  • control_onoff_device for on, off, and toggle actions.
  • control_level_device for brightness or dimming.
  • control_color_device for color temperature and hue/saturation.
  • read_attributes and write_attributes for Matter cluster data, including batch writes.
  • reset_controller for clearing controller storage after confirmation.

Limitations and notes

Commissioning depends on the device being available for pairing and, for network-based flows, reachable on the same network as the controller. Pairing codes, setup PINs, network connectivity, and device availability affect commissioning success. BLE commissioning additionally depends on system permissions and compatible hardware. Port conflicts can affect HTTP and SSE transports, while controller initialization depends on Matter.js dependencies and system compatibility.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Matter Controller MCP

Install the npm package from source with `npm install -g matter-controller-mcp`, or run it directly with `npx -y matter-controller-mcp`.

It documents MCP usage over stdio and provides a Cursor configuration example.

Yes. BLE commissioning is supported when enabled and can use Wi-Fi credentials; compatible hardware and appropriate permissions may be required.

High-level controls depend on device capabilities.

Related MCP servers

All in Embedded System All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMatter Controller MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/0x1abin-matter-controller-mcp?style=directory)](https://allmcps.com/mcp/0x1abin-matter-controller-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/0x1abin-matter-controller-mcp"><img src="https://allmcps.com/api/badge/0x1abin-matter-controller-mcp?style=directory" alt="Matter Controller MCP on AllMCPs" /></a>