millwork-mcp-lite
# millwork-mcp-lite
[](https://github.com/Toolibi/millwork-mcp-lite/actions/workflows/ci.yml) [](LICENSE) [](https://glama.ai/mcp/servers/Toolibi/millwork-mcp-lite)
**A free, open-source MCP server that gives an AI assistant basic cabinet-shop tools: schedule review, frameless cut lists and panel-saw sheet nesting.**
Ask Claude, ChatGPT, Copilot or any MCP client *"here's my kitchen, how many sheets of melamine do I need?"* and it calls real code to get the answer, instead of guessing.
Built by a 20-year cabinet/millwork CNC programmer. This is the free edition of [**millwork-mcp**](https://github.com/Toolibi/millwork-mcp), which takes cabinet drawings all the way to CNC-ready nests ([see the demos](https://github.com/Toolibi/millwork-mcp#demos)).
## Tools
All tools are read-only and deterministic: they compute from the job you pass in and never write files or touch a machine.
| Tool | What it does |
|---|---|
| `review_cabinet_schedule` | Flags duplicate tags, unknown cabinet types, odd sizes, doors that are too wide, shelves in sink bases |
| `build_cutlist` | Sides, bottoms, tops or rails, shelves, backs, doors and drawer fronts, with edgebanding and square footage per material |
| `count_sheets` | Quick takeoff: sheets needed for every material in the job |
| `nest_sheets` | Strip-cut (guillotine) nesting for a panel saw: sheets needed, yield, and where each part goes |
| `calculate_edgeband` | Linear feet of edgebanding per material, with a waste allowance |
| `list_cabinet_types` | Cabinet types, typical sizes and an example job, for turning drawings into a schedule |
| `get_server_info` | What this server does and what the full version adds |
Also included: a `plan_cabinet_job` prompt that walks an AI from a plain-language description to a material order, and two resources (`millwork://examples/small-kitchen`, `millwork://reference/construction`).
**Typical flow:** `review_cabinet_schedule` → `build_cutlist` → `count_sheets` / `nest_sheets` → `calculate_edgeband`
All dimensions are inches. Construction follows generic frameless (European-style) defaults: full-height sides, bottom between the sides, two 4" top rails on base cabinets, an applied 1/4" back, and full-overlay fronts with a 1/16" reveal.
## Quick start
```bash
pip install -r requirements.txt
python -m millwork_mcp_lite.server # stdio MCP server
python -m pytest -q # 11 tests
```
### Claude Desktop, Cursor, VS Code
No clone needed if you have [uv](https://docs.astral.sh/uv/):
```json
{
"mcpServers": {
"millwork-lite": {
"command": "uvx",
"args": ["--from", "git+https://github.com/Toolibi/millwork-mcp-lite", "millwork-mcp-lite"]
}
}
}
```
### Claude Code
```bash
claude mcp add millwork-lite -- uvx --from git+https://github.com/Toolibi/millwork-mcp-lite millwork-mcp-lite
```
### Docker
```bash
docker build -t millwork-mcp-lite .
docker run -i --rm millwork-mcp-lite
```
### Example job
```json
{
"job_number": "K-101",
"case_material": "MEL-WHT-34",
"back_material": "MEL-WHT-14",
"front_material": "MEL-WHT-34",
"cabinets": [
{"tag": "B1", "type": "base", "width": 24, "height": 34.5, "depth": 24, "doors": 1, "drawers": 1, "adj_shelves": 1},
{"tag": "W1", "type": "wall", "width": 30, "height": 30, "depth": 12, "doors": 2, "adj_shelves": 2}
]
}
```
Cabinet types: `base`, `drawer_base`, `sink_base`, `wall`, `tall`. A fuller sample is in [`examples/small_kitchen.json`](examples/small_kitchen.json): 8 cabinets come out to 9 sheets of 3/4" melamine and 3 sheets of 1/4" back.
## Lite vs. full
| | **lite** (this repo, MIT) | [**millwork-mcp**](https://github.com/Toolibi/millwork-mcp) |
|---|---|---|
| Schedule review | Basic checks | Plus material codes vs. price list, oversized doors, shop rules |
| Cut list | Generic frameless box | Configurable shop construction standard, finished ends, pre-lam, nailers |
| Joinery | - | 32mm system: dowel, confirmat, cam & dowel, Lamello Clamex |
| Grain matching | - | Doors and drawer fronts nested as matched blanks |
| Nesting | Panel-saw strip packing | Nested-router MaxRects (grain-locked, multi-start) or two-stage panel saw, sheet-size comparison |
| CNC output | - | woodWOP-ready DXF per sheet with machining layers, CNC program lists |
| Estimating | Sheet counts and edgeband takeoff | Material from the real nest + hardware + labor + markup |
| Inventory | - | Stock, offcuts, reserve → cut → consume |
| Hosting | Local (stdio) | Local or hosted on Azure / Microsoft Foundry, with approval on every shop-floor step |
Shops interested in the full version or a pilot: **Contact@princeboafo.com**
## Safety
Nothing here talks to a machine. Outputs are lists for a person to check before anything is cut.
## License
[MIT](LICENSE) © 2026 Prince Boafo. The full millwork-mcp is a separate project under its own license.
TDQS
Scored across 7 tools
Each tool targets a distinct step in the cabinet job workflow, and the descriptions explicitly steer callers between near-siblings (count_sheets vs nest_sheets, build_cutlist vs review_cabinet_schedule). The only soft overlaps are that count_sheets is a totals-only subset of nest_sheets and build_cutlist internally re-runs review, but both are called out in the text, so misselection risk is low.
All seven tools use the same snake_case verb_noun pattern (get_server_info, list_cabinet_types, nest_sheets, count_sheets, review_cabinet_schedule, build_cutlist, calculate_edgeband). The only nit is 'cutlist' vs 'cut_list', which is a trivial spelling choice, not a convention break.
Seven tools is a tight, well-scoped surface for a lite millwork helper: reference, validation, cut list, sheet counts, sheet layouts, and edgebanding. Every tool maps to a concrete step a user would actually ask for, with no filler.
The surface covers the full estimating-to-cut-list lifecycle: discover types, validate schedule, build parts, count sheets, nest layouts, and total edgeband. Gaps are mainly output/export (no CSV/PDF cut list writer) and costing/inventory, which are explicitly deferred to the full millwork-mcp, so agents can still work around them.