Skip to main content
Glama
millwork-mcp-lite

millwork-mcp-lite

millwork-mcp-lite

CI License: MIT Toolibi/millwork-mcp-lite MCP server

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

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.

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 tests

Claude 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-lite

Docker

docker build -t millwork-mcp-lite .
docker run -i --rm millwork-mcp-lite

Example 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)

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 © 2026 Prince Boafo. The full millwork-mcp is a separate project under its own license.

Available Tools

7 tools
build_cutlistBuild cut listA
Read-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 edgebandingA
Read-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 sheetsA
Read-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 infoA
Read-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 typesA
Read-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 sawA
Read-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 scheduleA
Read-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

    A4.5/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      3
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      10
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Free, 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.
      5
      17
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      10
      2
      MIT