# Honeywell Home MCP

> Honeywell Home MCP gives your AI client direct control over smart home functions—from security to climate. Use it to arm or disarm the system, check air quality readings (PM2.5, VOCs), and adjust thermostats remotely. It connects complex physical systems like HVAC units and cameras directly into natural conversation with any compatible agent.

## Overview
- **Category:** industry-titans
- **Price:** Free

## Description

Managing a house used to mean jumping through multiple apps: one for lights, another for the thermostat, and a third just for checking if everything was locked up. Now, you can handle it all through your AI client. You tell your agent, 'It's getting stuffy in here,' or 'Lock up before I leave.' Your agent handles the sequence of actions—reading sensor data, adjusting the temperature setpoint, and verifying that the system is properly armed.

This MCP exposes tools for everything from checking air quality metrics to taking a snapshot from any connected camera. It keeps your entire home environment accessible in one place. If you're building advanced automation logic, connecting through Vinkius makes sure that your agent has access to thousands of other integrations too. You stop managing apps and start giving commands.

## Tools

### get_air_quality
Returns detailed metrics on indoor air quality, including particulate and VOC levels.

### arm_system
Arms the security system in either 'stay' or 'away' mode after verifying the new status.

### get_camera_snapshot
Captures a single image snapshot from a specified camera device ID for quick visual inspection.

### get_camera_status
Checks if the designated security camera is currently online and operational using its device ID.

### get_devices
Lists all connected hardware devices at a specific location or across the whole account.

### disarm_system
Disarms the entire security system, which you do when personnel return to the property.

### get_locations
Retrieves a list of every registered physical address associated with your Honeywell Home account.

### get_security_status
Checks the current status, showing if the system is armed or disarmed and which sensors are active.

### update_setpoint
Adjusts the heat or cool setpoints, or changes the operating mode of a connected thermostat.

### get_thermostat_data
Retrieves detailed readings on the HVAC system's target temperature and whether it's actively running.

## Capabilities

### Manage Security Status
Arm or disarm the entire system using specific modes (stay or away) and check which sensors are currently reporting status.

### Control Climate Settings
Read current thermostat data, checking target temperatures, and actively adjust both the heat and cool setpoints from your agent.

### Monitor Air Quality
Retrieve detailed readings on air quality indicators like PM2.5 levels, VOC index, and CO2 concentrations to assess indoor breathing air.

### View Live Camera Feeds
Capture a single snapshot image from any connected camera or check the operational status of individual security devices.

### Inventory Home Devices
List all hardware, cameras, and sensors associated with specific addresses or across your entire account.

## Use Cases

### Checking a vacant property after hours
A facility manager needs to verify if the building is secure and climate-controlled. The agent first calls `get_security_status` to confirm it's armed, then runs `get_air_quality` to make sure CO2 levels haven't climbed too high from poor ventilation.

### Adjusting for an unexpected heatwave
A user realizes the house is too hot. They ask the agent, and it checks `get_thermostat_data` first. Then it executes `update_setpoint`, setting the cool setpoint lower while verifying the change with a second read.

### Investigating a potential break-in
After an alert, you ask your agent what happened. It runs `get_locations` to confirm the site, then uses `get_camera_snapshot` on the nearest camera ID, giving you immediate visual evidence without needing live video.

### Prepping a building for staff arrival
The ops engineer arrives early. The agent first calls `disarm_system`, then runs `get_devices` to ensure all systems are communicating, and finally uses `update_setpoint` to bring the temperature back into range.

## Benefits

- When you need to know if the air is stale, simply ask. The `get_air_quality` tool provides immediate data on VOCs and PM2.5 levels, letting you decide whether to run purification or open a window.
- Forget manually checking multiple apps for system status. Use `get_security_status` to get an instant report card on your whole home: armed/disarmed, plus the state of every door and window sensor.
- If you're running a sequence of tasks—say, preparing for nightfall—you can first run `get_thermostat_data` to see current settings, then use `update_setpoint` to adjust it without needing multiple steps.
- Need eyes on something? Instead of watching live video streams, the `get_camera_snapshot` tool lets you grab a single, clear image URL from any camera ID for quick verification.
- The agent manages complexity. You never have to worry about the order; just tell it what outcome you want, and your MCP handles calling tools like `get_devices`, then `get_locations`, before executing the final command.

## How It Works

The bottom line is: you talk to your agent once, and it handles the complex sequence of checks and actions required across multiple physical systems.

1. First, you must tell your agent which physical location you want to manage by calling `get_locations`.
2. Next, the agent uses that location ID to query specific data—like running `get_air_quality` or checking status with `get_security_status`.
3. Finally, when an action is needed (e.g., changing temperature), you invoke a control tool like `update_setpoint`, and your agent confirms the resulting state.

## Frequently Asked Questions

**How do I get a list of all cameras using the get_devices tool?**
You must first call `get_locations` to find your location ID. Then, pass that ID when calling `get_devices`. This will return all connected hardware, including camera IDs and device types.

**Can I change the thermostat settings with update_setpoint?**
Yes, you can adjust the heat setpoint (minimum temperature) or cool setpoint (maximum temperature). Remember to always use `get_thermostat_data` first to see what the current parameters are.

**What is the difference between get_camera_snapshot and get_camera_status?**
The status check only confirms if the camera is online; it's a boolean yes/no. The snapshot tool actually pulls an image URL, giving you a visual confirmation of what the camera sees right now.

**Is there a way to automate arming and disarming?**
Yes. You can build a routine where your agent first runs `get_security_status` (to confirm it’s currently disarmed), then calls `arm_system` with the desired mode, and finally runs `get_security_status` again to confirm success.

**How do I use the get_locations tool to start checking my home's devices?**
You must run `get_locations` first. This lists all registered homes and provides a location ID for each address. You need one of these IDs before you can query specific devices or security systems at that site.

**What metrics does the get_air_quality tool provide?**
The `get_air_quality` tool returns several crucial data points, including PM2.5 particulate levels and VOC index readings. You use this information to determine if you need to adjust ventilation or run air purification.

**After getting a location ID, how do I list all connected hardware using get_devices?**
Use the `get_locations` tool first to secure your site's specific ID. Then pass that location ID into `get_devices`. This gives you a full inventory of every piece of hardware registered at that address.

**What does get_security_status report beyond just armed or disarmed?**
The `get_security_status` tool provides granular detail on connected sensors. It reports the real-time status of individual components, such as open doors or triggered window sensors.