TCC-Matter Bridge

If you have a Honeywell RedLINK thermostat tied to Total Connect Comfort (TCC), this project makes it show up in Apple Home without replacing hardware. TCC-Matter Bridge is a service that talks to the Honeywell TCC cloud, exposes your thermostat as a Matter device, and lets the Apple Home app do the rest.

What it does

• Control your TCC thermostat from Apple Home
• Web UI for configuration and monitoring
• Live temperature and status updates
• Automatic reconnection and error handling

Architecture at a glance

TCC-Matter Bridge sits between Honeywell’s TCC cloud and your Apple Home hub. The Go backend manages the TCC session and exposes a local Web UI, while a Matter.js service presents a Matter thermostat device to HomeKit.

Quick start (Docker)

If you just want it running:

services:
  tcc-bridge:
    image: stephens/tcc-bridge:latest
    container_name: tcc-bridge
    restart: unless-stopped
    command: ["/app/bin/tcc-bridge", "-debug"]
    # Host networking required for Matter/HomeKit mDNS discovery
    network_mode: host
    volumes:
      - ./data:/app/data
    environment:
      - TZ=${TZ:-America/Los_Angeles}
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/api/status"]
      interval: 30s
      timeout: 3s
      start_period: 10s
      retries: 3

docker compose up -d

Then:

1. Open http://localhost:8080
2. Add your TCC credentials
3. Go to Pairing and scan the QR code
4. Your thermostat appears in Apple Home

Notes from building it

• Matter discovery needs host networking. network_mode: host is required so mDNS can find the bridge on your LAN.
• State lives on disk. The service stores a SQLite database and an encryption key in its data directory.
• The web UI is useful. It shows current state and logs without needing to SSH into the box.

If you want to dig deeper, the project is open source and includes full docs and build steps in the repo.

• Repo: https://github.com/rgstephens/tcc-bridge