Domotz MCP Server for Claude

Connect Claude AI to your Domotz network monitoring platform using the Model Context Protocol (MCP). This integration gives Claude access to 10 category tools covering 133 API actions, enabling natural language queries about your network infrastructure.

What This Does

With this MCP server, you can ask Claude things like:

• “Show me all devices on the network that are currently offline”
• “What’s the uptime history for my core switch(s) over the last month?”
• “List all collectors and their connection status”
• “Are there any active IP conflicts?”

Claude translates your natural language requests into Domotz API calls and presents the results in a readable format.

---

Prerequisites

Before you begin, ensure you have:

1. A Domotz account with API access enabled
2. Claude Desktop installed (download here)
3. Node.js 18+ installed on your system
4. Your Domotz API Key (see below for how to generate one)

---

Quick Start

Step 1: Generate Your Domotz API Key

1. Log into the Domotz Portal
2. Navigate to Account Settings → API Keys
3. Click Generate New Key
4. Copy and save the key securely (you won’t be able to see it again)

Step 2: Download the MCP Server Files

Clone or download this repository to your local machine:

git clone https://github.com/jacedomotz/domotz-mcp-server.git
cd domotz-mcp-server

Remember where you save this folder - you’ll need the full path in Step 4.

Step 3: Install Dependencies

npm install

Step 4: Configure Claude Desktop

Locate your Claude Desktop configuration file:

Open the file and add the Domotz MCP server configuration. Use claude_desktop_config.example.json as a reference:

{
  "mcpServers": {
    "domotz": {
      "command": "node",
      "args": ["REPLACE_WITH_FULL_PATH_TO/domotz-mcp-server/index.js"],
      "env": {
        "DOMOTZ_API_KEY": "YOUR_API_KEY_HERE",
        "DOMOTZ_API_BASE_URL": "https://api-us-east-1-cell-1.domotz.com/public-api/v1"
      }
    }
  }
}

You MUST customize three things:

1. args path - Replace with the full path to index.js on your machine:

   • Windows example: ["C:\\Users\\YourName\\domotz-mcp-server\\index.js"]
   • Mac example: ["/Users/yourname/domotz-mcp-server/index.js"]
   • Linux example: ["/home/yourname/domotz-mcp-server/index.js"]

2. DOMOTZ_API_KEY - Replace with your actual API key from Step 1

3. DOMOTZ_API_BASE_URL - Use the URL matching your Domotz account region:

   • US: https://api-us-east-1-cell-1.domotz.com/public-api/v1
   • Europe: https://api-eu-west-1-cell-1.domotz.com/public-api/v1