autodesk-inventor-mcp
Gives AI agents a live connection to a running Autodesk Inventor session over COM, so they can inspect and trial-fit models without any file export round-trips.
status— check the Inventor version and list open documents.model_info— inspect a part's bodies (face/edge/vertex counts, bounding box in mm) and its feature tree.smallest_faces— list the N smallest faces with area and center, to spot import defects like slivers fast.face_neighbors— find the faces sharing an edge with a given 1-based face index.unwrap_try— test an Unwrap on a face set and get success/failure, timing, result area and bounding box; the feature is rolled back unlesskeep: true.script— run arbitrary PowerShell against Inventor's COM API with$invand helpers predefined (powerful, but executes agent-written code, so keep approvals on).
Everything else is read-only and passes arguments as data, with lengths in mm and areas in mm² (Inventor's native cm units are converted).
Provides a live connection to Autodesk Inventor, enabling agents to inspect open part models, query bodies and features, find small/defective faces, explore face neighbors, test Unwrap operations safely, and run PowerShell against Inventor's COM API.
inventor-mcp
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_trycreates the feature, measures the result and deletes it again unless you passkeep: 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.pyClaude Desktop / Cursor / any MCP client (mcpServers config):
{
"mcpServers": {
"inventor": {
"command": "python",
"args": ["C:\\path\\to\\inventor-mcp\\server.py"]
}
}
}Tools
Tool | What it does |
| Inventor version and open documents |
| Bodies (face/edge/vertex counts, bounding box in mm) and the feature tree of a part |
| The N smallest faces with area and center. Finds import defects fast |
| Faces that share an edge with a given face |
| 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 |
| Runs arbitrary PowerShell against Inventor's COM API, with |
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). (callsface_neighborson face 287) They sit between two large B-spline faces, which is the classic sliver from a bad tessellation export. (callsunwrap_trywithout 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
agent-receipts: Skills that make AI coding agents prove "done" with real test output
blender-dlss5-neural-rendering: Blender viewport and renders through DLSS 5 neural rendering
metahuman-face-capture: MetaHuman face capture from a webcam in Blender
unreal-groom-alembic-exporter: Export UE Groom assets (MetaHuman hair) to Alembic
Available Tools
6 toolsface_neighborsFaces adjacent to a faceARead-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 featuresARead-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 InventorADestructive
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 facesARead-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 statusARead-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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
AI for Revit: 450+ tools, 1 undo step. Windows, Revit 2024–2027 (2021–2023 included). Free account.
AI clash detection in Navisworks Manage 2025–2027 on your PC. Needs the free plug-in.
AI Hub for AEC — 50+ 3D formats, clash detection, ACC integration via Autodesk Platform Services.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to control Autodesk Inventor via COM automation for part modeling, assembly constraints, drawing views, and more.8-
- AlicenseNot gradedqualityCmaintenanceEnables AI-driven control of Autodesk Navisworks via COM, supporting model tree browsing, property queries, searching, isolation, recoloring, and screenshots without a .NET add-in.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables 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.1MIT