Provides tools for interacting with Autodesk Fusion 360, enabling CAD automation through sketching, 3D modeling, body operations, assemblies, sheet metal, inspection, parameters, and CAM/manufacturing.
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 circle and extrude it 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.
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: Fusion MCP para Codex
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"
]
}
}
}Call the ping tool from your client. If it returns {"pong": true}, 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
Tool | Description |
| Health check (instant, no Fusion API) |
| Design name, bodies, sketches, features, camera |
| Detailed info about a named body or sketch |
| 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.) |
| 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) |
| 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 |
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 |
Tool | Description |
| Assign material appearance from library |
Tool | Description |
| List all user parameters |
| Create a new parameter |
| Update a parameter value |
| Remove a parameter |
Tool | Description |
| Export body as STL (supports bodies inside components) |
| Export body as STEP (supports bodies inside components) |
| Export design as Fusion archive |
Tool | Description |
| Create a manufacturing setup (milling/turning/cutting) |
| Add a machining operation (face, contour, adaptive, drilling, etc.) |
| Generate toolpaths for operations |
| Post-process to G-code (fanuc, grbl, haas, etc.) |
| 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 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 — tool results include isError=True when the add-in reports failures
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 (171 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.
Commands time out after 30 seconds.
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.
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, sketch_name, +1 more.
Add a driving dimension to constrain sketch geometry. Value is in cm for distances, degrees for angles.
Inputs: value (required), dimension_type (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: tool_body (required), target_body (required), operation.
Add a machining operation to a setup. Strategy determines the toolpath type.
Inputs: strategy (required), setup_name (required), name, coolant, +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, stock_mode, operation_type, +3 more.
Generate toolpaths for a specific operation or all operations in a setup
Inputs: setup_name, generate_all, operation_name.
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), output_units, output_folder, operation_name, +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: count (required), body_name (required), axis, total_angle.
Create a joint from components' current positions (easier than geometric joints)
Inputs: joint_type (required), component_one (required), component_two (required).
Add a bend to a sheet metal body
Inputs: body_name (required), angle, bend_radius, bend_line_sketch.
Create a box primitive (non-parametric via TemporaryBRepManager)
Inputs: width (required), height (required), length (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), body_name, plane_one, plane_two, +3 more.
Create a construction plane for sketching
Inputs: method (required), angle, plane, offset, +6 more.
Create a cylinder primitive (non-parametric via TemporaryBRepManager)
Inputs: height (required), radius (required), axis, base_x, +2 more.
Create a sheet metal flange on an edge
Inputs: body_name (required), edge_index (required), angle, height, +1 more.
Create a hole feature on a body face
Inputs: depth (required), diameter (required), center_x, center_y, +3 more.
Create a new user parameter
Inputs: name (required), unit (required), value (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_modeled, is_internal, +5 more.
Create a torus primitive (non-parametric via TemporaryBRepManager)
Inputs: major_radius (required), minor_radius (required), axis, center_x, +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: angle (required), body_name (required), face_selection, is_tangent_chain, +1 more.
Draw an arc in the most recent sketch (center + start point + sweep angle)
Inputs: start_x (required), start_y (required), center_x (required), center_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: end_x (required), end_y (required), start_x (required), start_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: points (required), spline_type (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.
Render canonical orthographic + isometric views as PNGs and emit a self-contained HTML sheet suitable for sharing with a mechanical engineer. Opens in any browser; Print -> Save as PDF for a static artifact. Restores the viewport camera after rendering.
Inputs: notes, title, views, image_size, +1 more.
Extend a sketch curve to the nearest intersection. The end nearest to the given point is extended.
Inputs: point_x (required), point_y (required), curve_index (required), sketch_name.
Extrude a sketch profile
Inputs: height (required), direction, operation, profile_index.
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).
Check if the design is in parametric or direct mode. Use this to detect accidental mode switches.
Inputs: no named parameters.
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: distance (required), body_name (required), face_indices, face_selection.
Create a patch surface from boundary edges
Inputs: sketch_name (required), continuity, profile_index.
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, y_count, x_spacing, +1 more.
Rename a body (searches root and all components)
Inputs: new_name (required), body_name (required).
Capture the active viewport as a PNG so you can visually verify the model. Pass a canonical view (iso/front/top/etc.) to reposition the camera first, or 'current' to keep it as is. Returns base64-encoded image bytes alongside metadata; the MCP server delivers it as an image content block.
Inputs: fit, view, width, height.
Revolve a sketch profile around an axis
Inputs: angle (required), operation, 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: scale (required), body_name (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), face_index, target_type.
Switch design type between 'parametric' and 'direct'. Use 'parametric' to recover from accidental direct-mode switches (equivalent to Capture Design History in the UI).
Inputs: design_type (required).
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), extend_tool, splitting_body, splitting_plane.
Split faces of a body using a plane
Inputs: body_name (required), extend_tool, face_indices, splitting_plane.
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), operation, path_curve_index.
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: point_x (required), point_y (required), curve_index (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 85 tools
Most tools have clearly distinct purposes (e.g., extrude vs revolve vs loft), but several CAM tools (cam_generate_toolpath, cam_post_process, cam_create_operation) and some feature tools (split_body vs split_face, create_bend vs create_flange) have subtle overlaps that could cause confusion without domain knowledge.
The vast majority of tools follow a consistent snake_case verb_noun pattern. A few naming quirks exist (e.g., 'extrude' and 'fillet' as bare verbs, and the 'cam_' prefix for CAM tools), but these are minor deviations and not misleading.
85 tools is excessive for a single MCP server, far exceeding the typical 3-15 range. While Fusion 360 is a broad domain, this count suggests poor scoping and will impose significant cognitive load on an agent.
The tool set covers an impressively complete range of Fusion 360 workflows: sketching, solid modeling, surface modeling, sheet metal, CAM, assemblies, parameters, measurement, rendering, and export. CRUD operations for parameters and components are present, and the domain coverage is comprehensive.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
