Bond

You can use this MCP server to control Bond Bridge hubs and their connected devices from your AI assistant or MCP client. It exposes device management, fan/shade/light controls, and custom Bond actions, letting you automate and streamline how you interact with RF devices around your home.

How to use

Connect your MCP client to the Bond MCP Server via the stdio configuration described below. Once connected, you can list all Bond devices, fetch detailed information, check current states, and get bridge status. You can control ceiling fans by setting speed and direction, operate motorized shades with open/close/set_position actions, and adjust dimmable lights by brightness. You can also send any Bond API action to devices and query bridge information as needed. Use the available tools to perform routine automations, such as turning on a fan when a room is occupied or opening shades at sunrise.

How to install

Prerequisites you need before starting are a Bond Bridge on your local network and a Bond API token obtained from the Bond Home app.

Create and activate a virtual environment for Python development.

python3 -m venv bond-mcp-env
source bond-mcp-env/bin/activate  # On Windows: bond-mcp-env\Scripts\activate

Install dependencies required by the Bond MCP server.

pip install -r requirements.txt

Configure environment for Bond Bridge access by copying the example and editing values.

cp .env.example .env
# Edit .env with your Bond Bridge settings

Run the Bond MCP server so you can start issuing commands to Bond devices.

python -m bond_mcp.server

Configuration and troubleshooting

Configuration details for running the Bond MCP server are provided through environment variables and command arguments. Below is a typical setup you will use to connect to Bond Bridge.

env
# Required Bond Bridge settings
BOND_TOKEN=your_bond_api_token_here
BOND_HOST=192.168.1.100

# Optional: Connection settings
BOND_TIMEOUT=10.0
BOND_MAX_RETRIES=3
BOND_RETRY_DELAY=1.0

# Optional: Logging
LOG_LEVEL=INFO

If you encounter issues, check common problems such as connection problems to the Bond Bridge, authentication using the Local Token, or whether a device ID exists when listing devices. Enable debug logging to diagnose problems more easily by setting LOG_LEVEL to DEBUG.

The server supports reporting bridge information, listing devices, and executing standard device actions. If a desired action is not supported by a device, verify the device details with list and get info operations to determine compatible actions.

Available tools

list_devices

Return a list of all Bond devices discovered by the Bridge.

get_device_info

Fetch detailed information about a specific Bond device by its ID.

get_device_state

Retrieve the current state of a Bond device (power, value, etc.).

get_bridge_info

Obtain information about the Bond Bridge itself, including status and configuration.

toggle_device_power

Toggle a Bond device on or off.

send_custom_action

Send a Bond API action directly to a device.

set_fan_speed

Set the speed for a Bond-connected ceiling fan (0-8).

set_fan_direction

Set the rotation direction of a Bond-connected ceiling fan (forward/reverse).

control_shades

Control motorized shades with open, close, or set_position actions.

set_light_brightness

Adjust the brightness of dimmable Bond lights (0-100).