Skip to main content
Glama

Bond MCP Server

by madorn

Bond MCP Server

A Model Context Protocol (MCP) server that provides tools for controlling Bond Bridge smart home devices. This server enables AI assistants like Claude to interact with ceiling fans, fireplaces, shades, lights, and other RF-controlled devices through Bond Bridge hubs.

Features

  • Device Management: List and get information about all connected Bond devices
  • Fan Control: Control ceiling fan speed, direction, and power state
  • Shade Control: Open, close, and set positions for motorized shades
  • Light Control: Control dimmable lights and brightness levels
  • Custom Actions: Send any Bond API action to devices
  • Bridge Information: Get Bond Bridge status and configuration

Quick Start

Prerequisites

  • Python 3.11 or higher
  • Bond Bridge on your local network
  • Bond API token (obtained from Bond Home app)

Installation

  1. Create and activate virtual environment:
    python3.11 -m venv bond-mcp-env source bond-mcp-env/bin/activate # On Windows: bond-mcp-env\Scripts\activate
  2. Install dependencies:
    pip install -r requirements.txt
  3. Configure environment:
    cp .env.example .env # Edit .env with your Bond Bridge settings
  4. Run the server:
    python -m bond_mcp.server

Getting Your Bond Token

  1. Open the Bond Home app on your mobile device
  2. Go to Settings → Bond Bridge → Advanced → API
  3. Copy the Local Token (not the Cloud Token)

Configuration

Create a .env file with your Bond Bridge configuration:

# 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

Podman Usage

Build and Run

# Build the container podman build -t bond-mcp-server . # Run with environment variables podman run -i --rm \ -e BOND_TOKEN=your_token_here \ -e BOND_HOST=192.168.1.100 \ bond-mcp-server

Available Tools

Device Management

  • list_devices() - List all Bond devices
  • get_device_info(device_id) - Get detailed device information
  • get_device_state(device_id) - Get current device state
  • get_bridge_info() - Get Bond Bridge information

Device Control

  • toggle_device_power(device_id) - Toggle device on/off
  • send_custom_action(device_id, action, argument?) - Send custom Bond action

Fan Control

  • set_fan_speed(device_id, speed) - Set fan speed (0-8)
  • set_fan_direction(device_id, direction) - Set direction ("forward"/"reverse")

Shade Control

  • control_shades(device_id, action, position?) - Control shades
    • Actions: "open", "close", "set_position"
    • Position: 0-100 (for set_position action)

Light Control

  • set_light_brightness(device_id, brightness) - Set brightness (0-100)

MCP Client Integration

Add to your MCP settings:

{ "mcpServers": { "bond": { "command": "podman", "args": [ "run", "-i", "--rm", "-e", "BOND_TOKEN=your_token_here", "-e", "BOND_HOST=192.168.1.100", "bond-mcp-server" ] } } }

Bond API Reference

This server uses the Bond Local API v2:

Troubleshooting

Common Issues

  1. Connection refused: Ensure Bond Bridge IP is correct and accessible
  2. Authentication failed: Verify Bond token is correct (use Local Token, not Cloud Token)
  3. Device not found: Check device ID exists using list_devices()
  4. Action not supported: Verify device supports the action using get_device_info()

Debug Logging

Enable debug logging by setting LOG_LEVEL=DEBUG in your environment.

License

This project is licensed under the MIT License. See the LICENSE file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables AI assistants to control Bond Bridge smart home devices including ceiling fans, motorized shades, dimmable lights, and other RF-controlled devices. Provides comprehensive device management and control capabilities through the Bond Local API.

  1. Features
    1. Quick Start
      1. Prerequisites
      2. Installation
      3. Getting Your Bond Token
      4. Configuration
    2. Podman Usage
      1. Build and Run
    3. Available Tools
      1. Device Management
      2. Device Control
      3. Fan Control
      4. Shade Control
      5. Light Control
    4. MCP Client Integration
      1. Bond API Reference
    5. Troubleshooting
      1. Common Issues
      2. Debug Logging
    6. License

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        Enables AI assistants to control SwitchBot devices, providing functionalities like device management, scene execution, and sensor information monitoring through the SwitchBot API.
        Last updated -
        3
        3
        JavaScript
        ISC License
      • A
        security
        A
        license
        A
        quality
        A bridge that connects physical hardware devices with AI large language models via serial communication, allowing users to control hardware using natural language commands.
        Last updated -
        3
        32
        Python
        MIT License
        • Apple
        • Linux
      • A
        security
        A
        license
        A
        quality
        Provides tools for AI assistants to interact with smart home devices through Home Assistant, allowing operations like checking entity states and calling services.
        Last updated -
        3
        1
        TypeScript
        MIT License
      • -
        security
        A
        license
        -
        quality
        A lightweight bridge enabling AI agents to perform real-world tasks on Android devices such as app navigation, UI interaction, and automated QA testing without requiring computer-vision pipelines or preprogrammed scripts.
        Last updated -
        29
        Python
        MIT License

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/madorn/bond-mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server