How to connect Domotz MCP to Claude

Connect Claude Web, Desktop and Cowork to Domotz MCP. List all devices on site office, show active alerts for site a, and more using natural language, with authentication handled for you.

Domotz MCP logoDomotz MCP
Api Key

Domotz MCP is a network-monitoring service that provides device discovery, alerts, and site telemetry. It helps IT teams monitor, troubleshoot, and manage networks remotely with clear device and alert visibility.

92 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Domotz account to Claude via Composio Connect, enabling it to list all devices on site Office, show active alerts for Site A, acknowledge alert 12345 and add note, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Domotz MCP with

Connecting Domotz to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Domotz account

Back in Claude, ask it to connect to Domotz or give it any Domotz-related task.

For example, ask Claude to:

  • "List all devices on site Office"
  • "Show active alerts for Site A"
  • "Acknowledge alert 12345 and add note"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Domotz account is ready to use.

What is the Domotz Claude Connector, and what's possible with it?

The Domotz MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Domotz account. It provides structured and secure access so your agent can perform Domotz operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Domotz?

The connector can show as connected, but Claude must use it in each Domotz conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Domotz again.

2. Why does Claude show an MCP server error before Domotz connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Domotz.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Domotz.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Domotz authorization link not work?

The Composio connector is one server. Your Domotz account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Domotz connection.
  • Composio creates a fresh Domotz authorization link.
  • Open that link in your browser and finish the Domotz sign-in.

4. Why do Domotz actions fail after they worked before?

The Domotz connection can expire or lose permission.

  • Ask Claude to inspect the Domotz connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Domotz account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Domotz.
  • If the action still fails with a permission error, check that the connected account has that permission in Domotz itself.

5. How do I switch to a different Domotz account?

Claude can manage the Domotz connection for you.

  • Ask Claude to disconnect or delete the current Domotz account.
  • Ask Claude to connect Domotz again.
  • Open the new Composio authorization link for Domotz.
  • Sign in with the other Domotz account in the browser.
  • After the account connects, ask Claude to retry the Domotz task.

6. Why is my Domotz connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Domotz connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click and click Clear cache.
  • If Domotz tools still do not appear, click , disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Domotz.
TOOLS

Supported Tools

Every Domotz MCP action and event your agent gets out of the box.

Apply device profile

Applies a device profile (a saved bundle of sensors, and optionally credentials) to one or more devices.

Attach driver

Attach a driver to a device.

Attach sensor

Attach a sensor to a device.

Bind alert rule to collector

Bind an existing alert rule to a collector.

Bind alert rule to device

Bind an existing alert rule to a specific device.

Bind collector to organization

Bind a Collector to an Organization (addressed by its internal `id`).

Bind tags

Bind tags to a device or to a collector, setting which tags it carries.

Collector discovery status

Returns the discovery dashboard data for a collector, including initial discovery progress, device statistics, collector issues, and device categories.

Collector overview

Fetch a high-level overview of a collector including its identity, health status, software version, uptime/downtime intervals, device counts, security issues, speed test results, and IP conflict status.

Compare config backup

Compares two configuration backup snapshots of the same device.

Create alert rule

Create an alert rule.

Create contact

Add a Contact to the Organization with the given internal `id`.

Create organization

Create a new Organization for the calling account.

Create tag

Create a new user-defined tag.

Cycle outlet power

Power-cycle a single outlet on a host device (PoE switch / PDU).

Delete alert rule

Delete an alert rule by ID.

Delete contact

Permanently delete a Contact from the Organization with the given internal `id`.

Delete device

PERMANENTLY delete one or more device records from a collector: the device and its history are removed entirely.

Delete driver

Permanently delete a driver from the account.

Delete organization

Permanently delete an Organization.

Delete tag

Delete a user-defined tag by ID.

Detach driver

Remove the binding between a driver and a device on the given collector.

Detach sensor

Detach a preconfigured (overlay) sensor from a device.

Device inventory

Returns detailed information about a single device: identity, status, capabilities, protocol coverage, attached sensors/drivers/profiles, OS info, location, power source, and end-of-life (EOL) status for firmware, software, and hardware.

Device performance

Fetch device performance metrics including round-trip delay, packet loss, uptime, SNMP sensor values, and disk usage over the last 7 days.

Execute driver

Run an action of a driver against a device.

Get account info

Returns identity and account context for the currently authenticated user: user ID, email, billing state, trial end date, whether the user is the account owner, and whether RBAC is enabled.

Get audit log filters

Return the set of values available for filtering Domotz audit logs: the operation categories (each with its operation types), source applications, target entities, actor entities, and outcome statuses currently present in the data.

Get collector alert rule bindings

List alert rules bound to a specific collector, including bindings at the collector level and bindings to variables owned by that collector.

Get collector capabilities

Inspect what the customer's Collector can actually run.

Get collector credential coverage

Collector-wide credential audit.

Get config backup entry

Returns a single configuration backup snapshot's text for a device.

Get config backup status

Lists devices on a collector that have configuration backup ('config backup') enabled, with the active backup driver, mode (READ_WRITE / READ_ONLY / AVAILABLE / INSUFFICIENT_PRIVILEGE / ERROR), status (ENABLED / DISABLED), failed-inspection count, and last inspection time.

Get create tag form

Shows an interactive form to create a new custom tag, with a name field and a color picker.

Get device alert rule bindings

List alert rules bound to a specific device, including device-level bindings and bindings to variables owned by that device.

Get device alerts

Retrieve alert and monitoring configuration status for a specific device.

Get device credentials

Per-device credential status drill-down.

Get device history

Returns the per-device History / Event Log for a single device: the chronological stream of events the device generated, most recent first.

Get device interfaces

Lists the SNMP-collected interfaces on a device.

Get device metrics

Fetch summarised time-series analytics for one or more named metrics on a device within a time range.

Get driver catalog

Lists the account-wide catalog of drivers available for attaching and executing on devices.

Get driver template

Fetch a single driver template, including its full JS code body and requirement metadata (`requirements.

Get interface traffic

Returns traffic counters for one or more device interfaces over a time range.

Get network configuration

Fetch what a collector actually scans, to answer 'why isn't this device discovered?

Get organization

Get the full details of a single Organization by its internal `id`: name, `organization_id` (the caller-facing reference), its Contacts, and the ids of the Collectors bound to it.

Get snmp credentials form

Shows an interactive form to set or update SNMP credentials on a specific device.

Get uptime

Returns uptime stats for a collector or device over a time range: total uptime percentage, online_seconds, total_seconds, and the list of downtime intervals.

Inspect driver

Static analysis of a driver's JS against the Domotz sandbox.

List alert rules

Lists alert rule definitions in the account.

List collector metrics

Enumerate the metrics available on a collector — speed-test thresholds, IP-conflict status, collector uptime, security-issues counts, and the rest of the collector-scoped metric catalog.

List communication channels

List the user's notification channels (email, webhook, Slack, etc.

List config backup history

Lists configuration backup snapshots for a device on a collector, newest first.

List device drivers

Lists drivers currently attached to a device.

List device metrics

List everything monitorable on a device.

List device profiles

Lists device profiles in the account.

List device sensors

Lists the sensors currently attached to a device, merged across CUSTOM_OID, TCP, CUSTOM_DRIVER, and PRECONFIGURED kinds.

List device types

Returns the device-type catalog used to classify devices (router, switch, AP, server, etc.

List driver templates

List shared driver templates the account can start from.

List metric functions

List the evaluation functions (e.

List organizations

List the account's Organizations with their Contacts and bound Collector ids.

List preconfigured sensors

Returns the account-wide catalog of preconfigured sensors available to attach via `attach_sensor(sensor_spec={kind: 'overlay', overlay_id: .

List tags

Returns the account-wide catalog of user-defined tags applied to devices and collectors.

List variable alert rule candidates

List alert rules that could be bound to a specific device variable.

Manage external hosts

Add or remove an external host on a collector.

Manage ip scan policy

Manage the collector's forced IP scan policy: extra addresses the collector must probe on top of what it discovers by itself.

Manage routed networks

Add, update or remove a routed network on a collector.

Network topology

Returns the network topology discovered by a single collector: device-to-device links and per-outlet (port) details.

Resolve alert

Permanently resolve one or more alert incidents.

Save driver

Create or update a driver on the account.

Search alerts

Search alert history with filters.

Search audit logs

Search Domotz audit logs for the caller's organization.

Search collectors

Search and list Domotz collectors with filtering and pagination (zero-based: first page is page=0).

Search devices

Cross-account device search with filters and pagination (zero-based: first page is page=0).

Search organizations

List and filter the organizations visible to the calling user.

Set collector default snmp credentials

Set the collector's DEFAULT SNMP credentials — the ones used for devices that have no SNMP credentials of their own.

Set device credential

Set or overwrite a device credential.

Set device power

Change the power state of a device: turn it `on`, hold it `off`, `cycle` it, or issue a `software_reboot`.

Set interfaces policy

Set which of the collector's own network interfaces take part in discovery, by name.

Snooze collector alerts

Snooze (temporarily mute) all alerting for a collector for a maintenance window.

Submit feedback

Submit feedback about a gap in available MCP tools or data.

Unbind alert rule from collector

Unbind an alert rule from a collector.

Unbind alert rule from device

Unbind an alert rule from a device.

Unbind collector from organization

Unbind a Collector from an Organization (addressed by its internal `id`).

Unsnooze collector alerts

Resume alerting on a collector immediately, cancelling any active snooze/maintenance window set by `snooze_collector_alerts`.

Update alert rule

Update an existing alert rule in place, preserving its device/collector/variable bindings and alert history (unlike deleting and recreating).

Update collector metadata

Update editable metadata on a collector (the on-site monitoring agent).

Update collector monitoring settings

Update how the collector monitors, as opposed to what it monitors.

Update contact

Update a Contact on the Organization with the given internal `id`.

Update device metadata

Update editable metadata fields on a device: `name`, `importance` (important or not important), `zone`, `room`, `serial`, `notes` (max 256 chars).

Update device monitoring state

Manage or unmanage one or more devices by changing their monitoring state.

Update organization

Update an existing Organization by its internal `id`.

Update tag

Rename an existing user-defined tag, change its colour, or both.

FAQ

Frequently asked questions

With a standalone Domotz MCP server, the agents and LLMs can only access a fixed set of Domotz tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Domotz and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Domotz tools.

Yes, absolutely. You can configure which Domotz scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Domotz data and credentials are handled as safely as possible.

Start with Domotz MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Domotz MCP tool your agent needs.Free to start.

Start building