Home Connect Integration

The Home Connect integration provides access to manage Home Connect list appliances, get appliance, get status, get programs, start program through the Integrate MCP server.

Installation

The Home Connect integration is included with the SDK:

import { homeConnectIntegration } from "integrate-sdk/server";

Setup

1. Create a Home Connect OAuth App

1. Create an OAuth application for Home Connect
2. Configure your redirect URI
3. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Home Connect integration to your server configuration. The integration automatically reads HOME_CONNECT_CLIENT_ID and HOME_CONNECT_CLIENT_SECRET from your environment variables:

import { createMCPServer, homeConnectIntegration } from "integrate-sdk/server";
 
export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    homeConnectIntegration({
      scopes: ["IdentifyAppliance", "Monitor", "Settings", "Control"], // Optional
    }),
  ],
});

You can override the environment variables by passing explicit values:

homeConnectIntegration({
  clientId: process.env.CUSTOM_HOME_CONNECT_ID,
  clientSecret: process.env.CUSTOM_HOME_CONNECT_SECRET,
      scopes: ["IdentifyAppliance", "Monitor", "Settings", "Control"], // Optional
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";
 
await client.authorize("home_connect");
const result = await client.home_connect.listAppliances({});
 
console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, homeConnectIntegration } from "integrate-sdk";
 
const customClient = createMCPClient({
  integrations: [homeConnectIntegration()],
});

Configuration Options

export interface HomeConnectIntegrationConfig {
  clientId?: string;

Default Scopes

These defaults are applied unless you override scopes in the integration config:

• IdentifyAppliance
• Monitor
• Settings
• Control

Tools

home_connect_list_appliances

Connect list appliances

No parameters.

home_connect_get_appliance

Connect get appliance

export interface HomeConnectGetApplianceParams { ha_id: string }

home_connect_get_status

Connect get status

export interface HomeConnectGetStatusParams { ha_id: string }

home_connect_get_programs

Connect get programs

export interface HomeConnectGetProgramsParams { ha_id: string }

home_connect_start_program

Connect start program

export interface HomeConnectStartProgramParams { ha_id: string;

home_connect_set_setting

Connect set setting

export interface HomeConnectSetSettingParams { ha_id: string;

Notes

• Category: Lifestyle
• Authentication mode: OAuth