spoolman-mcp

[](https://github.com/Disane87/spoolman-mcp) [](https://opensource.org/licenses/MIT) [](https://www.typescriptlang.org/) [](https://modelcontextprotocol.io/) [](https://github.com/Donkie/Spoolman)

> A [Model Context Protocol](https://modelcontextprotocol.io/) server for [Spoolman](https://github.com/Donkie/Spoolman) — manage your entire 3D printer filament inventory through natural language with Claude and other AI assistants! 🎉

---

This MCP server bridges the gap between AI assistants (like Claude) and your self-hosted Spoolman instance. Instead of clicking through the Spoolman UI, you can simply ask your AI assistant:

> _"How much PLA do I have left?"_ > _"Add a new Bambu Lab PETG spool, 1kg, red."_ > _"Mark spool #12 as used by 50g."_

The server exposes the full Spoolman REST API v1 as MCP tools — every vendor, filament, spool, setting, custom field, lookup, and export endpoint is covered.

---

• 🏭 Vendor Management — Create, read, update, delete vendors
• 🎨 Filament Management — Full CRUD with color, temperature settings, article numbers
• 🧵 Spool Management — Track spools, log usage (by weight or length), weight measurement, archiving
• ⚙️ Settings — Read and write Spoolman configuration
• 🏷️ Custom Fields — Manage extra fields for vendors, filaments, and spools
• 🔍 Lookups — Browse all materials, locations, lot numbers, article numbers
• 📦 Export — Export data as JSON or CSV
• 💓 System — Health chec