Skip to main content
Glama
autodesk-inventor-mcp

autodesk-inventor-mcp

inventor-mcp

effectustasi/autodesk-inventor-mcp MCP server

An MCP server that gives AI agents (Claude Code, Claude Desktop, Cursor, Codex…) a live connection to Autodesk Inventor.

Ask your agent things like "which faces in this imported STEP are tiny slivers?" or "will Unwrap work on these 12 faces?" and it reads the answer straight from the open model.

  • Zero dependencies: one Python file, standard library only.

  • Live: talks to the running Inventor session over COM (via Windows PowerShell). No export, no file round-trips.

  • Units you think in: lengths in mm, areas in mm² (Inventor's internal unit is cm; the server converts).

  • Safe by default: unwrap_try creates the feature, measures the result and deletes it again unless you pass keep: true.

Requirements

  • Windows with Autodesk Inventor installed and running (developed against Inventor 2027)

  • Python 3.9+

Related MCP server: navisworks-mcp

Install

Clone or download server.py, then register it with your agent.

Claude Code

claude mcp add inventor -- python C:\path\to\inventor-mcp\server.py

Claude Desktop / Cursor / any MCP client (mcpServers config):

{
  "mcpServers": {
    "inventor": {
      "command": "python",
      "args": ["C:\\path\\to\\inventor-mcp\\server.py"]
    }
  }
}

Tools

Tool

What it does

status

Inventor version and open documents

model_info

Bodies (face/edge/vertex counts, bounding box in mm) and the feature tree of a part

smallest_faces

The N smallest faces with area and center. Finds import defects fast

face_neighbors

Faces that share an edge with a given face

unwrap_try

Tries an Unwrap on a face set and reports success, timing, result area and bounding box, the details the GUI doesn't show. Rolls back by default

script

Runs arbitrary PowerShell against Inventor's COM API, with $inv and helpers predefined

Face indices are 1-based and stable for a given body as long as the model doesn't change.

⚠️ About the script tool

script executes any PowerShell your agent writes, with your user's permissions. That's what makes it powerful (anything in the Inventor API is reachable), and it's also why you should keep your agent's tool-approval prompts on for it. If you don't want it, delete its entry from TOOLS in server.py.

All other tools pass arguments as data, never as code.

Example (illustrative)

You: The STEP I imported won't unwrap. What's wrong with it?

Agent: (calls smallest_faces) Body 1 has 412 faces; the 6 smallest are under 0.01 mm², clustered around (12.4, -3.1, 40.0). (calls face_neighbors on face 287) They sit between two large B-spline faces, which is the classic sliver from a bad tessellation export. (calls unwrap_try without them) Unwrap succeeds in 1.8 s when those 6 faces are excluded.

Contributing

Issues and PRs are welcome, especially new read-only tools (assemblies, sketches, iProperties, sheet metal), Inventor-version compatibility reports, and non-English Windows fixes. See the issues labeled good first issue.

License

MIT. Not affiliated with or endorsed by Autodesk. Autodesk and Inventor are trademarks of Autodesk, Inc.

More tools by effectustasi

Available Tools

6 tools
face_neighborsFaces adjacent to a faceA
Read-onlyIdempotent

Returns the given face and every face that shares an edge with it, each with index, area in mm^2, edge count, surface type and center point in mm; neighbors are sorted by area, largest first. Use it to see what a suspicious small face sits between before excluding or fixing it.

Inputs: index (required), body, document.

model_infoPart bodies and featuresA
Read-onlyIdempotent

Summarizes a part document: for each body, whether it is solid, its face/edge/vertex counts and its bounding box in mm; plus the feature tree (name, type, suppressed) and the number of Unwrap features. Use it to orient yourself in a model before inspecting individual faces.

Inputs: document.

scriptRun PowerShell against InventorA
Destructive

Escape hatch for anything the other tools don't cover: runs arbitrary PowerShell with full access to Inventor's COM API and the user's permissions. Predefined: $inv (Inventor.Application), $MISSING (for optional COM arguments), Get-Doc (document by display name, or active) and FaceInfo (area/center in mm). The script must write exactly one line of JSON, e.g. @{ n = $inv.Documents.Count } | ConvertTo-Json -Compress. Prefer the dedicated tools when they fit; this one can modify or close documents.

Inputs: script (required), timeout.

smallest_facesFind the smallest facesA
Read-onlyIdempotent

Lists the N smallest faces of a body, sorted by area ascending. Each entry has the 1-based face index, area in mm^2, edge count, surface type and center point in mm. Also returns the body's total face count and total area. Use it to find import defects such as sliver or near-zero-area faces from STEP/IGES files; the returned indices work with face_neighbors and unwrap_try.

Inputs: body, count, document.

statusInventor session statusA
Read-onlyIdempotent

Checks that Autodesk Inventor is running and reachable over COM. Returns the Inventor version, the active document, and every open document with its file path, type and unsaved-changes flag. Call this first to get the document names the other tools accept.

Inputs: no named parameters.

unwrap_tryDry-run an UnwrapA

Attempts Inventor's Unwrap feature on a set of faces and reports what happened: success or the error and Inventor's last error message, time taken, and on success the result face count, area in mm^2 and bounding box in mm. By default the created feature is deleted right away so the document is left unchanged; pass keep=true to leave it in the model. Use it to find which face set unwraps, which the Inventor UI does not tell you.

Inputs: face_indices (required), body, keep, document, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: status for connection/document discovery, model_info for body/feature overview, smallest_faces for defect hunting, face_neighbors for adjacency context, unwrap_try for testing unwrap operations, and script as an explicit escape hatch. There is no overlap in intent, and descriptions clarify when to use each.

    Naming Consistency4/5

    Most names follow a consistent lower_snake_case convention (model_info, smallest_faces, face_neighbors, unwrap_try), with only 'status' being a bare noun rather than a verb_noun pattern. The convention is readable and nearly uniform.

    Tool Count5/5

    Six tools is well-scoped for an Inventor COM bridge: each tool covers a specific analysis or discovery need, and the script tool prevents the surface from ballooning. No tool feels redundant or missing from the core set.

    Completeness4/5

    The surface covers connection status, model orientation, defect detection, neighbor inspection, unwrap testing, and arbitrary COM scripting, which handles the apparent mesh/unwrap analysis domain well. Gaps include no direct face repair or exclusion tools, but the script escape hatch mitigates most dead ends.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to control Autodesk Inventor via COM automation for part modeling, assembly constraints, drawing views, and more.
      8
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI-driven control of Autodesk Navisworks via COM, supporting model tree browsing, property queries, searching, isolation, recoloring, and screenshots without a .NET add-in.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI assistant to drive an already-running SOLIDWORKS session over its COM API, so it can build sketches, solid features, reference geometry, assemblies, mates, and engineering drawings, then inspect the result through topology listings, mass properties, measurements, and screenshots returned as images.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables an MCP-capable AI client to drive a locally installed, licensed Autodesk Inventor through its COM API for local modeling tasks. It supports creating and updating a rectangular plate and a parametric quickchanger concept assembly, opening and inspecting parts and assemblies, and returning viewport previews.
      1
      MIT