How do I use spoolman-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@spoolman-mcp How much PLA do I have left?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

spoolman-mcp

by Disane87

Overview Schema Related Servers Score Discussions

TypeScript

Remote

🧵 Spoolman MCP Server

Version License: MIT TypeScript MCP Spoolman

A Model Context Protocol server for Spoolman — manage your entire 3D printer filament inventory through natural language with Claude and other AI assistants! 🎉

🚀 What is this?

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.

Related MCP server: StashDog MCP Server

✨ Features

🏭 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 check, info, and backup trigger

NOTE

This server communicates with yourlocal/self-hosted Spoolman instance. You need a running Spoolman before using this MCP server.

📋 Requirements

Requirement	Version
Node.js	≥ 18
npm	≥ 9
Spoolman	Any recent version
Claude Desktop / Claude Code	Any

⚡ Quick Start

1. Clone & Install

git clone https://github.com/Disane87/spoolman-mcp.git
cd spoolman-mcp
npm install
npm run build

2. Configure Claude Desktop

Add the following to your claude_desktop_config.json:

macOS / Linux: ~/.config/claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "spoolman": {
      "command": "node",
      "args": ["/absolute/path/to/spoolman-mcp/dist/index.js"],
      "env": {
        "SPOOLMAN_URL": "http://localhost:7912"
      }
    }
  }
}

IMPORTANT

Replace/absolute/path/to/spoolman-mcp with the actual path where you cloned the repository, and http://localhost:7912 with the URL of your Spoolman instance.

3. Restart Claude Desktop & Start Chatting! 🎉

🔧 Configuration

The server is configured via environment variables:

Variable	Required	Description	Example
`SPOOLMAN_URL`	✅ Yes	Base URL of your Spoolman instance	`http://localhost:7912`
`SPOOLMAN_API_KEY`	❌ No	Bearer token (if behind a proxy with auth)	`my-secret-key`

🛠️ Available MCP Tools

🏭 Vendors

Tool	Description
`spoolman_list_vendors`	Search and list all vendors
`spoolman_get_vendor`	Get a single vendor by ID
`spoolman_create_vendor`	Create a new vendor
`spoolman_update_vendor`	Update an existing vendor
`spoolman_delete_vendor`	Delete a vendor (cascades to filaments!)

🎨 Filaments

Tool	Description
`spoolman_list_filaments`	Search filaments by name, material, color, vendor...
`spoolman_get_filament`	Get a single filament by ID
`spoolman_create_filament`	Create a new filament definition
`spoolman_update_filament`	Update an existing filament
`spoolman_delete_filament`	Delete a filament

🧵 Spools

Tool	Description
`spoolman_list_spools`	Search spools with extensive filters
`spoolman_get_spool`	Get a single spool by ID
`spoolman_create_spool`	Register a new spool
`spoolman_update_spool`	Update spool metadata
`spoolman_delete_spool`	Delete a spool
`spoolman_use_spool`	Log filament consumption (g or mm)
`spoolman_measure_spool`	Update remaining weight via scale measurement

⚙️ Settings

Tool	Description
`spoolman_get_all_settings`	Get all Spoolman settings
`spoolman_get_setting`	Get a specific setting by key
`spoolman_set_setting`	Change a setting value

🏷️ Custom Fields

Tool	Description
`spoolman_list_fields`	List custom fields for an entity type
`spoolman_upsert_field`	Add or update a custom field
`spoolman_delete_field`	Remove a custom field

🔍 Lookups

Tool	Description
`spoolman_list_materials`	List all known material types
`spoolman_list_locations`	List all storage locations
`spoolman_list_lot_numbers`	List all lot/batch numbers
`spoolman_list_article_numbers`	List all article numbers
`spoolman_rename_location`	Rename a storage location

📦 Export

Tool	Description
`spoolman_export_spools`	Export all spools as JSON or CSV
`spoolman_export_filaments`	Export all filaments as JSON or CSV
`spoolman_export_vendors`	Export all vendors as JSON or CSV

💓 System

Tool	Description
`spoolman_get_info`	Get Spoolman version and config info
`spoolman_health_check`	Check if Spoolman is reachable
`spoolman_trigger_backup`	Trigger a database backup (SQLite only)

💬 Example Conversations

Once connected, you can have natural conversations like:

You: How many spools do I currently have?

Claude: You have 14 spools in Spoolman. 3 of them are archived.
        The active spools include 5x PLA, 4x PETG, and 2x ABS.

You: Add a new Bambu Lab PLA Basic spool. It's red, 1kg, 1.75mm.

Claude: I'll create that for you right away!
        ✅ Spool created: Bambu Lab PLA Basic (Red) — 1000g remaining.

You: I just printed something and used about 45g from spool #7.

Claude: Done! Spool #7 now has 623g remaining (was 668g).

You: I just weighed spool #3 on my kitchen scale — it's 312g total.

Claude: Got it! Based on the empty spool weight of 190g, spool #3
        now shows 122g of filament remaining.

🏗️ Project Structure

spoolman-mcp/
├── src/
│   ├── index.ts          # MCP server entry point & transport
│   ├── client.ts         # Typed Spoolman REST API client
│   └── tools/
│       ├── system.ts     # System tools (health, info, backup)
│       ├── vendors.ts    # Vendor CRUD tools
│       ├── filaments.ts  # Filament CRUD tools
│       ├── spools.ts     # Spool management tools
│       ├── settings.ts   # Settings tools
│       ├── fields.ts     # Custom field tools
│       ├── lookup.ts     # Lookup / discovery tools
│       └── export.ts     # Data export tools
├── dist/                 # Compiled JavaScript (after npm run build)
├── package.json
├── tsconfig.json
└── README.md

🔨 Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode (auto-rebuild on changes)
npm run watch

# Run directly with ts-node (no build step)
SPOOLMAN_URL=http://localhost:7912 npm run dev

🤝 Contributing

Contributions are welcome! Feel free to open an issue or pull request if you find a bug, have a feature idea, or want to improve the documentation.

Fork the repository
Create a feature branch (git checkout -b feat/my-feature)
Commit your changes (git commit -m 'feat: add my feature')
Push to the branch (git push origin feat/my-feature)
Open a Pull Request

📄 License

MIT License — see LICENSE for details.

Check out these other projects from the Spoolman ecosystem:

Project	Description
🏠 Spoolman Home Assistant	Integrate Spoolman with Home Assistant — track spools, get notifications, automate your printing workflow
🎨 Spoolman Filament Swatch	Beautiful, interactive filament color browser for Spoolman. Live Demo
📦 Spoolman Filament Extractor	Extract your filaments from Spoolman to SpoolmanDB format
🗄️ SpoolmanDB	Centralized community filament database used by Spoolman
🖨️ Spoolman	The awesome filament manager that powers everything

🙏 Credits

Spoolman by @Donkie — the awesome filament management system that makes this possible
Model Context Protocol by Anthropic — the open standard powering AI tool integration
Inspired by spoolman-homeassistant 💙

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Snipe-IT MCP Server
Databases Developer Tools
Wil-Collier
F
license
-
quality
D
maintenance
Enables AI assistants to manage Snipe-IT inventory systems through comprehensive asset and consumable operations. Supports creating, updating, tracking, and managing IT assets, consumables, maintenance records, file attachments, and generating labels.
Last updated 2025-10-14
1
StashDog MCP Server
App Automation E-commerce & Retail
dogfoodlab-io
F
license
B
quality
F
maintenance
Enables AI assistants to manage StashDog inventory through natural language commands, supporting item management, collections, tags, smart search, and URL imports with secure authentication.
Last updated 2026-02-10
11
OrcaSlicer MCP Server
Software Architecture Developer Tools App Automation
itsumonotakumi
A
license
A
quality
F
maintenance
Enables AI agents to interact with OrcaSlicer to manage profiles, adjust printing settings, and perform slicing operations. It allows users to search settings, slice STL/3MF files, and analyze G-code metadata through natural language assistants.
Last updated 2026-02-08
7
AGPL 3.0
odin-print-farm-mcp
Autonomous Agents App Automation
HughKantsime
A
license
-
quality
C
maintenance
Enables AI agents to operate a 3D print farm via O.D.I.N. backend, including job queuing, printer control, inventory management, and standalone cost calculators.
Last updated 2026-05-21
11
Apache 2.0

View all related MCP servers

Related MCP Connectors

0nMCP — Universal AI API Orchestrator
Universal AI API Orchestrator — 1,554 tools, 96 services. One install.
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
DynamicEndpoints-autogen_mcp
Create and manage AI agents that collaborate and solve problems through natural language interacti…

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/Disane87/spoolman-mcp'

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

🧵 Spoolman MCP Server

🚀 What is this?

✨ Features

📋 Requirements

⚡ Quick Start

1. Clone & Install

2. Configure Claude Desktop

3. Restart Claude Desktop & Start Chatting! 🎉

🔧 Configuration

🛠️ Available MCP Tools

🏭 Vendors

🎨 Filaments

🧵 Spools

⚙️ Settings

🏷️ Custom Fields

🔍 Lookups

📦 Export

💓 System

💬 Example Conversations

🏗️ Project Structure

🔨 Development

🤝 Contributing

📄 License

🔗 Related Spoolman Projects

🙏 Credits

Maintenance

Resources

Looking for Admin?

Related MCP Servers

Snipe-IT MCP Server

StashDog MCP Server

OrcaSlicer MCP Server

odin-print-farm-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API