Source: https://spooly.eu/en/docs/changelog

# Changelog

What changes in the API, the MCP server and the Home Assistant integration, newest version first.

## 0.3.1

9 November 2026, changes field names when creating and updating spools

- Spools use the same field names for reading and writing. When creating and updating, the fields are now called `color_hex`, `material`, `finish`, `spool_size_grams`, `empty_spool_grams` and `location_id` (before: `color`, `filament_type`, `color_finish`, `spool_size`, `empty_spool_weight`, `storage_location_id`).
- Spools also return `name`, `color_name`, `empty_spool_grams`, `notes`, `location_id` and `place`. `material` is always the material with its variant as in the app, such as PLA Basic. `finish` only takes the values of the app.
- Places: move and create take `place`, locations report their number of places (`places`). New error codes `place_taken` and `place_invalid`.
- Spoolman address: a new spool with “location · Platz N” keeps its place.
- Home Assistant integration 0.3.1: `spooly.move` takes a place such as “Cabinet · Shelf 1 · Platz 2”, new attributes `color_name`, `empty_spool_grams`, `location_id` and `place`.

## 0.3.0

1 November 2026, first beta

- REST API at `/api/v1` with 24 endpoints on 21 paths: read and change spools, slots, locations, maintenance and printer hours, plus prints, printers, statistics and what is due.
- MCP server at `/api/mcp` with 23 tools for AI assistants.
- Sign-in with a click for Claude, ChatGPT, Claude Code and Home Assistant, keys for everyone else.
- Spreadsheet link: active spools as CSV.
- Home Assistant integration 0.3.0: entities for spools, slots, maintenance, monthly usage and stock value, plus 9 actions.
- Change list per connection with Undo for weight, slots and completed maintenance.