<!-- Canonical page: https://reversedwithai.com/p/spinn-coffee-maker-aws-iot-protocol-dizzycoffee-claude -->
Canonical page: https://reversedwithai.com/p/spinn-coffee-maker-aws-iot-protocol-dizzycoffee-claude

# Decoded the Spinn coffee maker's cloud and MQTT protocol with Claude

> Local command line control of a bean-to-cup coffee maker without the vendor app, written with Claude.

The repository documents the reverse engineered sign-in, REST and MQTT protocol of Spinn machines. Claude Opus 4.8 and 5.5 co-author trailers appear on 27 commits.

## Key facts

- Target: Spinn bean-to-cup coffee maker
- Category: APIs and protocols
- Platform: Python, AWS IoT MQTT
- Models: Claude Opus 4.8, Claude Opus 5.5
- Tools: Python, MQTT, AWS IoT
- Outcome: Works
- Checks: Source available: yes; Repro steps: not reported; Real hardware: not reported; Verified by others: not reported
- Author: [spiegela](https://github.com/spiegela)
- Added: 2026-11-20
- Updated: 2026-11-20
- Sources reviewed: 2026-11-20 (automated reviewer)

## What was done

DizzyCoffee is a read-mostly Python command line tool for the Spinn bean-to-cup coffee maker. The README says the machines are AWS IoT Core appliances: the phone app signs the user in, fetches a client certificate for that user's own machine and talks to it over MQTT with mutual TLS. The tool repeats that sequence for the owner's machine so state and brewing can be reached from tools such as Home Assistant. The protocol is written up in docs/PROTOCOL.md.

### How it was done

Claude Opus 4.8 and Claude Opus 5.5 co-author trailers appear on most of the commits, along with Claude session links. Commands that change state ask for confirmation and have a dry-run mode.

### Results

The README says sign-in, device and certificate fetch, the AWS IoT connection, reading the shadow and brewing were verified end to end against a real machine.

## Sources

- [Repository](https://github.com/spiegela/dizzycoffee)

Figures are reported by the author and not measured by this site, except the commit history. Entry drafted with AI from the linked sources and checked against them.

Cite as: spiegela (2026). Decoded the Spinn coffee maker's cloud and MQTT protocol with Claude. Reversed with AI. https://reversedwithai.com/p/spinn-coffee-maker-aws-iot-protocol-dizzycoffee-claude
