Fusion360 MCP Server lets AI agents drive Autodesk Fusion 360 for CAD automation over MCP — from sketching and modeling to CAM, inspection, and export.
Scene & query: ping, get scene info, object info, bounding boxes, component listing
Design type: check/switch parametric vs direct modeling
Sketching: create sketches, draw lines/rectangles/circles/arcs/splines/polygons, add constraints and dimensions, offset/trim/extend/project geometry
3D features: extrude, revolve, sweep, loft, fillet, chamfer, shell, mirror, holes, patterns, threads, draft, split, offset faces, scale, suppress/unsuppress features
Body operations: move/rename bodies, boolean join/cut/intersect, undo, delete all
Direct primitives: non-parametric box/cylinder/sphere/torus and parametric history-based boxes
Surface operations: patch, stitch, thicken, ruled surfaces, trim surfaces
Sheet metal: flanges, bends, flat patterns, unfold
Construction geometry: planes, axes, user coordinate systems
Assembly: create components, add joints, as-built joints, rigid groups
Inspection/analysis: measure distance/angle, physical properties, section analysis, interference checks, mesh comparison
Appearance: assign material appearances and flat RGB colors with opacity
Parameters: list/create/update/delete user parameters
Import/export: import meshes; export STL, STEP, F3D, PNG view sheets; unified export dispatcher
CAM/manufacturing: create setups/operations, generate toolpaths, post-process to G-code, list setups/operations, get operation info
Code execution: run arbitrary Python inside Fusion 360
Perception: render the active viewport as a PNG for visual verification
Provides tools for CAD automation in Autodesk Fusion 360, enabling AI agents to manage sketches, 3D modeling features, assemblies, physical analysis, and CAM manufacturing processes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Fusion360 MCP Server create a 50mm square on the XY plane and extrude it by 10mm"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Last updated: 2026-09-16
Beta — This project is under active development. APIs and tool behavior may change between releases. Use at your own discretion. Feedback and bug reports welcome via GitHub Issues.
MCP server that connects AI coding agents to Autodesk Fusion 360 for CAD automation.
Tested with Claude Code. Works with any MCP-compatible client — OpenCode, Codex, Cursor, or anything that speaks the Model Context Protocol.
Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main ThreadTwo components:
MCP Server (this repo) — Python process that speaks MCP protocol to Claude and forwards commands over TCP
Fusion360MCP Add-in (installed in Fusion's AddIns folder) — runs inside Fusion 360, executes API calls safely on the main thread
Related MCP server: Fusion360MCP
uv (Python package manager)
Autodesk Fusion 360
An MCP-compatible client (Claude Code, OpenCode, Codex, Cursor, etc.)
Quick install (symlink for development):
./scripts/install-addon.shManual install:
# macOS
cp -r addon ~/Library/Application\ Support/Autodesk/Autodesk\ Fusion\ 360/API/AddIns/Fusion360MCP
# Windows (PowerShell)
Copy-Item -Recurse addon "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"Then start it in Fusion: Shift+S → Add-Ins → Fusion360MCP → Run
You should see [MCP] Server listening on localhost:9876 in the TEXT COMMANDS window.
The MCP server is published on PyPI — no need to clone this repo.
claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socketThe server runs over stdio, so any MCP-compatible client can launch it. The command is:
uvx fusion360-mcp-server --mode socket{
"mcpServers": {
"fusion360": {
"command": "uvx",
"args": [
"fusion360-mcp-server",
"--mode", "socket"
]
}
}
}If the MCP server and Fusion 360 run on different machines (e.g. MCP server on a Mac Mini, Fusion on a Windows PC), override the bind/connect address via environment variables on both sides.
On the Fusion host (where the add-in runs), bind to all interfaces before starting Fusion:
# Windows
$env:FUSION_MCP_HOST = "0.0.0.0"# macOS / Linux
export FUSION_MCP_HOST=0.0.0.0Then start Fusion and run the Fusion360MCP add-in. The log line Server listening on 0.0.0.0:9876 confirms the bind.
On the MCP-server host, point the client at the Fusion host's LAN IP:
# Either via CLI flag
uvx fusion360-mcp-server --mode socket --host 192.168.1.42
# Or via env var (useful in MCP client configs)
FUSION_MCP_HOST=192.168.1.42 uvx fusion360-mcp-server --mode socketSecurity note: the TCP socket has no authentication. Only expose it on a trusted LAN — never bind to 0.0.0.0 on a host reachable from the public internet.
Call the ping tool from your client. If it returns {"ok": true, "status": "pong"}, everything is connected.
Remove the fusion360 entry from your MCP client config
Stop the add-in in Fusion (Shift+S → Add-Ins → Fusion360MCP → Stop)
Delete the add-in folder from Fusion's AddIns directory
Tools marked (2026+) require a recent Fusion build — they use APIs introduced in the January–July 2026 releases and are live-tested on Fusion 2705 (arm64).
Tool | Description |
| Health check (instant, no Fusion API) |
| Design name, bodies, sketches, features, camera |
| Detailed info about a named body or sketch |
| Axis-aligned bbox (min/max/size/center) for body or component; unions all bodies when called on a component |
| List all components in the design |
Tool | Description |
| Check if design is in parametric or direct mode |
| Switch design type (parametric/direct recovery) |
Tool | Description |
| New sketch on xy/yz/xz plane, optional offset |
| Rectangle in most recent sketch |
| Circle in most recent sketch |
| Line in most recent sketch |
| Arc (center + start + sweep angle) |
| Fit-point or control-point spline |
| Regular polygon (3–64 sides) |
| Geometric constraint (coincident, parallel, tangent, etc.) |
| (2026+) Auto-constrain a sketch via the AutoConstrain API — 3 result options (thorough / fast / tolerance-adjusting) |
| Driving dimension (distance, angle, radial, diameter) |
| Offset connected sketch curves |
| Trim at intersections |
| Extend to nearest intersection |
| Project edges/bodies onto sketch plane |
Tool | Description |
| Extrude a sketch profile |
| Revolve a profile around an axis |
| Sweep a profile along a path |
| Loft between two or more profiles |
| Round edges (all/top/bottom/vertical) |
| Chamfer edges |
| Hollow out a body |
| Mirror a body across a plane |
| Hole feature on a body face |
| Pattern in rows and columns |
| Pattern around an axis |
| Add threads (cosmetic or modeled) |
| Draft/taper faces for mold release |
| Split a body using a plane |
| Split faces of a body |
| Push/pull faces by a distance |
| Scale uniformly or non-uniformly |
| Suppress a timeline feature |
| Re-enable a suppressed feature |
Tool | Description |
| Translate a body by (x, y, z) |
| Rename a body (searches root and all components) |
| Join/cut/intersect two bodies |
| Clear the design |
| Undo last operation (with design-type safety guard) |
Tool | Description |
| Box (via TemporaryBRepManager, history-less) |
| History-based box: sketch rectangle + dimensions + extrude. |
| Cylinder |
| Sphere |
| Torus |
Tool | Description |
| Create a patch surface from boundary edges |
| Stitch surface bodies into one |
| Thicken a surface into a solid |
| Ruled surface from an edge |
| Trim a surface with another body |
Tool | Description |
| Create a flange on an edge |
| Add a bend |
| Create flat pattern |
| Unfold specific bends |
Tool | Description |
| Offset, angle, midplane, 3-point, tangent |
| Two-point, intersection, edge, perpendicular |
| (2026+, preview API) User Coordinate System at a point with optional rotation |
Tool | Description |
| Create a sub-assembly component |
| Joint between two components |
| Joint from current positions |
| Lock components together |
Tool | Description |
| Minimum distance between entities |
| Angle between entities |
| Mass, volume, area, center of mass |
| Section plane through model |
| Detect collisions between components |
| (2026+) Deviation statistics between two mesh bodies (min/max/mean/RMS, cm) — e.g. validate against a reference STL |
Tool | Description |
| Assign material appearance from library |
| (2026+) Assign a flat RGB color (+ opacity) to a body |
Tool | Description |
| List all user parameters |
| Create a new parameter |
| Update a parameter value |
| Remove a parameter |
Tool | Description |
| Import STL/OBJ/3MF as mesh body via |
| Export body as STL (supports bodies inside components) |
| Export body as STEP (supports bodies inside components) |
| Export design as Fusion archive |
| Export multi-view PNG sheet (iso/front/top/right) for visual inspection |
| Unified dispatcher — routes to |
Tool | Description |
| Create a manufacturing setup (milling/turning/cutting); applies stock mode/offsets |
| Add a machining operation (face, contour, adaptive, drilling, etc.); applies stepdown/feed/speed/coolant parameters |
| Generate toolpaths for operations |
| Post-process to G-code — pass a full |
| List all manufacturing setups |
| List operations in a setup |
| Get operation details (strategy, tool, parameters) |
Tool | Description |
| Run arbitrary Python in Fusion (REPL-style) |
Tool | Description |
| Capture the active viewport as PNG (optional camera preset: iso/front/top/...). Returns an image block for visual verification |
Tool annotations — each tool is tagged with readOnlyHint, destructiveHint, and idempotentHint so MCP clients can auto-approve safe operations
Resources — fusion360://status, fusion360://design, fusion360://parameters for passive state inspection
Resource templates — fusion360://body/{name}, fusion360://component/{name} for dynamic entity lookup
Prompts — create-box, model-threaded-bolt, sheet-metal-enclosure workflow templates
Structured errors — failures carry isError=True plus a stable error_kind (e.g. BODY_NOT_FOUND, TIMEOUT), contextual hints, and a traceback; infrastructure errors (bridge timeout, unknown command) are classified the same way, not flattened to a generic message
Mock mode — --mode mock returns plausible test data without Fusion running (all responses include "mode": "mock")
uv sync --dev # install deps
uv run pytest -v # run tests (363 tests)
uv run ruff check # lintAll Fusion API units are centimeters (Fusion's internal unit).
One operation per tool call. Batching multiple operations crashes the add-in.
Timeouts: the add-in's main-thread bridge times out after 30s and cancels the queued command; the client waits up to 45s so it receives that structured TIMEOUT error. Mutation commands are never auto-retried — after a timeout, call get_scene_info to check whether anything was applied before retrying.
Add-in logs to ~/fusion360mcp.log.
The undo tool includes a design-type safety guard — it checks before/after and auto-redoes if the undo would switch from parametric to direct mode.
Tested on Fusion 2705.1.15 (macOS arm64). Tools marked (2026+) need a build from 2026 or later.
Inspired by BlenderMCP — the socket bridge architecture originated there.
Also built on ideas from the existing Fusion 360 MCP ecosystem:
MIT
Add a geometric constraint in the active sketch. Entities are referenced by index within the sketch.
Inputs: constraint_type (required), entity_one, entity_two, symmetry_line, +1 more.
Add a driving dimension to constrain sketch geometry. Value is in cm for distances, degrees for angles.
Inputs: dimension_type (required), value (required), entity_one, entity_two, +1 more.
Add a joint between two components
Inputs: component_one (required), component_two (required), joint_type.
Combine two named bodies (join/cut/intersect)
Inputs: target_body (required), tool_body (required), operation.
Add a machining operation to a setup. Strategy determines the toolpath type.
Inputs: setup_name (required), strategy (required), name, tool_number, +6 more.
Create a manufacturing setup for a body. Defines the stock, coordinate system, and operation type (milling/turning/cutting).
Inputs: body_name (required), name, operation_type, stock_mode, +3 more.
Generate toolpaths for a specific operation or all operations in a setup
Inputs: setup_name, operation_name, generate_all.
Get details about a specific operation (strategy, tool, parameters, toolpath status)
Inputs: setup_name (required), operation_name (required).
List operations within a setup
Inputs: setup_name (required).
List all manufacturing setups in the document
Inputs: no named parameters.
Post-process toolpaths to generate NC code (G-code)
Inputs: setup_name (required), operation_name, post_processor, output_folder, +1 more.
Chamfer edges of a body
Inputs: distance (required), body_name, body_index, edge_selection.
Detect collisions between components/bodies
Inputs: component_names (required), include_coincident_faces.
Pattern a body around an axis
Inputs: body_name (required), count (required), axis, total_angle.
Create a joint from components' current positions (easier than geometric joints)
Inputs: component_one (required), component_two (required), joint_type (required).
Add a bend to a sheet metal body
Inputs: body_name (required), bend_line_sketch, angle, bend_radius.
Create a box primitive (non-parametric via TemporaryBRepManager)
Inputs: length (required), width (required), height (required), center_x, +2 more.
Create a new component (sub-assembly) in the design
Inputs: name (required), parent_name.
Create a construction axis
Inputs: method (required), point_one, point_two, plane_one, +3 more.
Create a construction plane for sketching
Inputs: method (required), plane, offset, angle, +6 more.
Create a cylinder primitive (non-parametric via TemporaryBRepManager)
Inputs: radius (required), height (required), base_x, base_y, +2 more.
Create a sheet metal flange on an edge
Inputs: body_name (required), edge_index (required), height, angle, +1 more.
Create a hole feature on a body face
Inputs: diameter (required), depth (required), body_name, body_index, +3 more.
Create a new user parameter
Inputs: name (required), value (required), unit (required), comment.
Draw a regular polygon in the most recent sketch
Inputs: sides (required), radius (required), center_x, center_y, +1 more.
Lock multiple components together
Inputs: component_names (required), include_children.
Cut a section plane through the model
Inputs: plane, offset.
Create a new sketch on xy/yz/xz plane, optionally offset
Inputs: plane, z_offset.
Create a sphere primitive (non-parametric via TemporaryBRepManager)
Inputs: radius (required), center_x, center_y, center_z.
Add threads to a cylindrical face (cosmetic or modeled)
Inputs: body_name (required), face_index (required), is_internal, thread_type, +5 more.
Create a torus primitive (non-parametric via TemporaryBRepManager)
Inputs: major_radius (required), minor_radius (required), center_x, center_y, +2 more.
Clear the design (delete all timeline items)
Inputs: no named parameters.
Remove a user parameter
Inputs: name (required).
Add a draft angle to faces of a body (for mold release / injection molding)
Inputs: body_name (required), angle (required), face_selection, pull_direction_plane, +1 more.
Draw an arc in the most recent sketch (center + start point + sweep angle)
Inputs: center_x (required), center_y (required), start_x (required), start_y (required), +3 more.
Draw a circle in the most recent sketch
Inputs: radius (required), center_x, center_y, center_z.
Draw a line in the most recent sketch
Inputs: start_x (required), start_y (required), end_x (required), end_y (required), +2 more.
Draw a rectangle in the most recent sketch
Inputs: width (required), height (required), origin_x, origin_y, +1 more.
Draw a spline in the most recent sketch. Use fit_points for a curve through points, or control_points for a control-polygon spline.
Inputs: spline_type (required), points (required), degree.
Run arbitrary Python in Fusion 360. The last expression's value is returned (REPL-style). Pre-defined names: app, ui, design, component, adsk, math.
Inputs: code (required).
Export the design as a native Fusion 360 archive (.f3d)
Inputs: file_path.
Export a body or component as a STEP file
Inputs: body_name (required), file_path.
Export a named body as an STL file
Inputs: body_name (required), file_path.
Extend a sketch curve to the nearest intersection. The end nearest to the given point is extended.
Inputs: curve_index (required), point_x (required), point_y (required), sketch_name.
Extrude a sketch profile
Inputs: height (required), profile_index, operation, direction.
Round edges of a body
Inputs: radius (required), body_name, body_index, edge_selection.
Create a flat pattern from a sheet metal body
Inputs: body_name (required).
Get detailed info about a named body or sketch
Inputs: name (required).
List all user parameters in the design
Inputs: no named parameters.
Get mass, volume, surface area, center of mass, and density of a body
Inputs: body_name (required), accuracy.
Get design name, bodies, sketches, features, camera info
Inputs: no named parameters.
List all components in the design
Inputs: no named parameters.
Loft between two or more sketch profiles
Inputs: profile_sketch_names (required), operation.
Measure angle between two entities
Inputs: entity_one (required), entity_two (required).
Measure minimum distance between two entities
Inputs: entity_one (required), entity_two (required).
Mirror a body across a construction plane
Inputs: mirror_plane (required), body_name, body_index.
Translate a named body by (x, y, z)
Inputs: body_name (required), x, y, z.
Offset connected sketch curves by a distance. Direction is determined by the direction_point.
Inputs: curve_index (required), offset_distance (required), direction_x, direction_y, +1 more.
Push/pull faces of a body by a distance
Inputs: body_name (required), distance (required), face_selection, face_indices.
Create a patch surface from boundary edges
Inputs: sketch_name (required), profile_index, continuity.
Health check — returns immediately without touching Fusion API
Inputs: no named parameters.
Project edges or bodies onto the active sketch plane
Inputs: source_name (required), is_linked, sketch_name.
Pattern a body in rows and columns
Inputs: body_name (required), x_count, x_spacing, y_count, +1 more.
Revolve a sketch profile around an axis
Inputs: angle (required), profile_index, axis_origin_x, axis_origin_y, +5 more.
Create a ruled surface from an edge or sketch curve
Inputs: body_name (required), edge_index (required), distance, rule_type.
Scale a body uniformly or non-uniformly
Inputs: body_name (required), scale (required), scale_x, scale_y, +4 more.
Assign a material appearance to a body, face, or component from the Fusion appearance library
Inputs: target_name (required), appearance_name (required), target_type, face_index.
Update the value of an existing user parameter
Inputs: name (required), value (required).
Hollow out a body by removing a face
Inputs: thickness (required), body_name, body_index, face_selection.
Split a body using a plane or face
Inputs: body_name (required), splitting_plane, splitting_body, extend_tool.
Split faces of a body using a plane
Inputs: body_name (required), face_indices, splitting_plane, extend_tool.
Stitch surface bodies into a single body
Inputs: body_names (required), tolerance.
Suppress (disable) a feature in the timeline
Inputs: feature_name (required).
Sweep a sketch profile along a path (sketch curve)
Inputs: profile_index (required), path_sketch_name (required), path_curve_index, operation.
Thicken a surface body into a solid
Inputs: body_name (required), thickness (required), direction.
Trim a sketch curve at its intersections. The segment nearest to the given point is removed.
Inputs: curve_index (required), point_x (required), point_y (required), sketch_name.
Trim a surface body with another body
Inputs: body_name (required), tool_name (required).
Undo the last operation
Inputs: no named parameters.
Unfold specific bends in a sheet metal body
Inputs: body_name (required), bend_indices.
Unsuppress (re-enable) a feature in the timeline
Inputs: feature_name (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 80 tools
Most tools have distinct purposes, but some overlap exists, such as 'create_box', 'create_cylinder', 'create_sphere', and 'create_torus' all being primitive creation tools, which could cause minor confusion. However, the descriptions clarify their specific geometric shapes, reducing ambiguity.
Tool names follow a highly consistent verb_noun pattern throughout, such as 'add_constraint', 'create_sketch', 'export_step', and 'measure_distance'. There are no deviations in naming conventions, making the set predictable and readable.
With 80 tools, the count is excessive for a single server, making it overwhelming and difficult for agents to navigate efficiently. While Fusion 360 is a complex CAD/CAM system, this many tools likely includes overly granular or redundant operations that could be consolidated.
The tool set provides comprehensive coverage for Fusion 360's domain, including sketching, modeling, assembly, manufacturing (CAM), sheet metal, parameters, export, and analysis. There are no obvious gaps; it supports full CRUD/lifecycle operations and advanced workflows.
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Connect your AI to your own devices, 3D printers, factory tools and a shared agent task pool.
A browser 3D CAD for your AI: it scripts real-size models, uCAD builds them and returns pictures.
