millwork-mcp-lite
A read-only, deterministic MCP server for basic cabinet-shop takeoff and panel-saw preparation.
Review cabinet schedules for duplicate tags, unknown types, bad sizes, door-width issues, and other errors/warnings.
Build frameless cabinet cut lists with parts, materials, edgebanding, and square footage.
Count full sheets needed per material for a job.
Nest one material’s parts into guillotine-safe panel-saw sheet layouts with yield and oversize-part reporting.
Calculate linear feet of edgebanding per material with optional waste allowance.
List supported cabinet types, typical sizes, construction defaults, and an example job.
Report server capabilities, license, typical flow, and what the full millwork-mcp adds.
Provide a
plan_cabinet_jobprompt and example/reference resources from the README.
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, which takes cabinet drawings all the way to CNC-ready nests (see the 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 |
| Flags duplicate tags, unknown cabinet types, odd sizes, doors that are too wide, shelves in sink bases |
| Sides, bottoms, tops or rails, shelves, backs, doors and drawer fronts, with edgebanding and square footage per material |
| Quick takeoff: sheets needed for every material in the job |
| Strip-cut (guillotine) nesting for a panel saw: sheets needed, yield, and where each part goes |
| Linear feet of edgebanding per material, with a waste allowance |
| Cabinet types, typical sizes and an example job, for turning drawings into a schedule |
| 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.
Related MCP server: AIKEA
Quick start
pip install -r requirements.txt
python -m millwork_mcp_lite.server # stdio MCP server
python -m pytest -q # 11 testsClaude Desktop, Cursor, VS Code
No clone needed if you have uv:
{
"mcpServers": {
"millwork-lite": {
"command": "uvx",
"args": ["--from", "git+https://github.com/Toolibi/millwork-mcp-lite", "millwork-mcp-lite"]
}
}
}Claude Code
claude mcp add millwork-lite -- uvx --from git+https://github.com/Toolibi/millwork-mcp-lite millwork-mcp-liteDocker
docker build -t millwork-mcp-lite .
docker run -i --rm millwork-mcp-liteExample job
{
"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: 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) | ||
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 © 2026 Prince Boafo. The full millwork-mcp is a separate project under its own license.
Available Tools
7 toolsbuild_cutlistBuild cut listARead-onlyIdempotent
Turn a cabinet schedule into a part-by-part cut list for frameless cabinets.
Use when someone needs the parts to cut, a parts count, or square footage per material. For sheet counts use count_sheets; for sheet layouts use nest_sheets; for edgebanding length use calculate_edgeband.
Construction (generic defaults): full-height sides; bottom between the sides; two 4" top rails on base, drawer_base and sink_base, a full top on wall and tall; adjustable shelves 1/16" narrower than the opening and 1" plus the back thickness shallower than the box; an applied back, full width x full height; full-overlay doors and drawer fronts with a 1/16" reveal. Runs review_cabinet_schedule first and returns {error, review} instead of parts if the schedule has errors.
Returns: {job_number, summary: {total_pieces, by_material: {code: {pieces, square_feet}}}, parts: [{cabinet, name, material, length, width, qty, edgeband ("front"|"all"|""), notes}], review}. length is the long/grain direction; all sizes are finished inches.
Example: a 24" base with 1 door and 1 shelf gives 2 sides 34.5x24, a bottom 22.5x24, 2 top rails 22.5x4, a shelf 22.4375x22.75, a back 34.5x24 and a door 34.375x23.875.
Inputs: job (required).
calculate_edgebandCalculate edgebandingARead-onlyIdempotent
Calculate the linear feet of edgebanding a job needs, per material, with a waste allowance.
Use when ordering edgeband rolls or pricing edgebanding. For sheet goods use count_sheets; for the individual parts and which edges they get, use build_cutlist (its edgeband field drives this total).
Counted edges: the front edge of sides, bottoms, tops, top rails and adjustable shelves ('front'), and all four edges of doors and drawer fronts ('all'). Backs get no edgebanding. Edgeband is grouped by the part's material code, so doors in front_material are totalled separately from case parts.
Parameters: waste_pct is the extra percentage added for trimming and machine setup, 0-50 (default 10).
Behaviour: read-only and deterministic. Runs review_cabinet_schedule first and returns {error, review} instead of totals if the schedule has errors.
Returns: {job_number, waste_pct, by_material: {code: {linear_feet, with_waste_linear_feet}}, total_with_waste_linear_feet}. Feet are rounded to 0.1.
Example: one 30" x 30" x 12" wall cabinet with one door and waste_pct=0 gives 19.7 linear feet of the case material (sides, bottom and top front edges plus the door perimeter).
Inputs: job (required), waste_pct.
count_sheetsCount sheetsARead-onlyIdempotent
Count how many full sheets each material in the job needs (quick material takeoff).
Use for bids and ordering ("how many sheets of melamine do I need?"). It runs the same panel-saw nesting as nest_sheets for every material but returns only the totals; call nest_sheets when someone needs the layouts.
Returns: {job_number, sheet_size, materials: {code: {sheets, yield_pct, oversize_parts}}}. oversize_parts counts parts that do not fit the sheet and need a bigger sheet or a joint.
Example: the bundled sample kitchen (8 cabinets) returns 9 sheets of 3/4" case material and 3 sheets of 1/4" back on 48 x 96 sheets.
Inputs: job (required), sheet_width, sheet_length.
get_server_infoGet server infoARead-onlyIdempotent
What millwork-mcp-lite does, its license, and what the full millwork-mcp adds (CNC router nesting, woodWOP DXF output, 32mm joinery, grain matching, estimating, inventory).
Use when someone asks what this server can do, or needs something outside the lite tools. Takes no input.
Returns: {name, license, tools, typical_flow, full_version, full_version_adds, contact}.
Inputs: no named parameters.
list_cabinet_typesList cabinet typesARead-onlyIdempotent
Reference for building a job: the cabinet types this server understands, with typical sizes and which fields each uses.
Use before calling the other tools when you are turning drawings or a description into a schedule and are unsure which type or size to use. Takes no input.
Returns: {units, types: {type: {description, typical: {width, height, depth}, uses}}, defaults: {construction rules and thicknesses}, example_job}.
Inputs: no named parameters.
nest_sheetsNest sheets for a panel sawARead-onlyIdempotent
Lay out one material's parts on full sheets for a panel saw and report the cutting plan.
Use when someone needs the actual sheet layouts (which part goes where). For just the number of sheets across every material, count_sheets is faster. The layout is strip-cut and guillotine-safe: each sheet is ripped into strips across its width, then parts are crosscut from each strip. Parts keep their listed grain direction (length runs along the sheet). 1/4" is trimmed off each sheet edge. Not for CNC routers.
Parameters: material is a material code from the job (defaults to case_material); sheet_length and sheet_width in inches (default 96 x 48); kerf is the saw blade width in inches (default 0.125).
Returns: {job_number, material, sheet_size, sheets_needed, parts_nested, overall_yield_pct, oversize_parts: [parts too big for the sheet], sheets: [{sheet, yield_pct, strips: [{rip_width, y, parts: [{cabinet, name, length, width, x}]}]}]}. x and y are inches from the sheet's corner.
Example: {"job": {...}, "material": "MEL-WHT-34", "sheet_length": 97, "sheet_width": 49}.
Inputs: job (required), kerf, material, sheet_width, +1 more.
review_cabinet_scheduleReview cabinet scheduleARead-onlyIdempotent
Check a cabinet schedule for mistakes before anything is calculated or cut.
Use this first on any schedule read from drawings or typed by a person. It does not build parts; use build_cutlist for that (build_cutlist also runs this review and refuses to continue on errors).
Checks: duplicate tags, unknown cabinet types, non-positive sizes, widths outside 9-48", single doors wider than 24", drawer bases with no drawers, shelves in sink bases, unusual base heights (not 30-36") and deep wall cabinets (over 16").
Returns: {job_number, ok (true when there are no errors), errors (count), warnings (count), issues: [{level: "error"|"warning", cabinet: tag, message}]}. Errors block the cut list; warnings need a person to confirm.
Example: {"job": {"job_number": "K-101", "cabinets": [{"tag": "B1", "type": "base", "width": 36, "height": 34.5, "depth": 24, "doors": 1}]}} -> ok=true with one warning that the single door would be about 36" wide.
Inputs: job (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Cutlist optimization for sheet, linear and roll stock, with grain, kerf, nesting and saw exports.
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Construction takeoff and estimating for AI agents. Measure a drawing PDF, export a priced estimate.
Cabinet quotes, job status, selling prices and kitchen estimates. Read-only tools with OAuth.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables professional furniture design from dimensions and type to a complete manufacturing package, including structural validation, cut optimization, BOM generation, assembly instructions, interactive HTML report with 3D viewer, and optional FreeCAD export.3MIT
- AlicenseAqualityCmaintenanceEnables users to design flat-pack furniture such as bookcases, cabinets, cubes and desks through natural-language conversation, then generates CNC-ready DXFs, cut and hardware lists, printable assembly instructions and a quote request for a fabricator.10MIT
- AlicenseAqualityAmaintenanceFree, open-source 2D nesting for fixed sheets (laser, CNC, plasma, waterjet, fabric): SVG/DXF import, part-in-part nesting across several sheets, validation and export. Runs as an MCP server, on the command line and in the browser.517MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to turn a furniture description into a parametric design, cut list, plywood sheet nesting, lumber cutting plan and dimensioned builder drawings, with no CAD required. When CadQuery or a licensed Autodesk Fusion is available, it also builds exact STEP/STL models and verifies them against the kernel.102MIT