Skip to content
Back to search

fusion360-mcp-server

MCP Server for Autodesk Fusion 360

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/faust-machines--fusion360-mcp-server/badge.svg)](/listings/faust-machines--fusion360-mcp-server)

HTML

<a href="/listings/faust-machines--fusion360-mcp-server"><img src="/api/listings/faust-machines--fusion360-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the Fusion 360 Add-in

**Quick install (symlink for development):**

./scripts/install-addon.sh

**Manual 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.

2. Connect your MCP client

The MCP server is published on [PyPI](https://pypi.org/project/fusion360-mcp-server/) — no need to clone this repo.

Claude Code

claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socket

Other MCP clients

The server runs over **stdio**, so any MCP-compatible client can launch it. The command is:

uvx fusion360-mcp-server --mode socket

<details> <summary><strong>Cursor</strong> (~/.cursor/mcp.json)</summary>

{
  "mcpServers": {
    "fusion360": {
      "command": "uvx",
      "args": [
        "fusion360-mcp-server",
        "--mode", "socket"
      ]
    }
  }
}

</details>

Cross-machine setup (LAN)

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.0

Then 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 socket

**Security 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.

3. Verify

Call the `ping` tool from your client. If it returns `{"ok": true, "status": "pong"}`, everything is connected.

Uninstalling

1. Remove the `fusion360` entry from your MCP client config 2. Stop the add-in in Fusion (Shift+S → Add-Ins → Fusion360MCP → Stop) 3. Delete the add-in folder from Fusion's AddIns directory

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 331 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Fusion360 MCP Server
  2. *Last updated: 2026-09-16*
  3. > **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](https://github.com/faust-machines/fusion360-mcp-server/issues).
  4. MCP server that connects AI coding agents to Autodesk Fusion 360 for CAD automation.
  5. Tested with [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Works with any MCP-compatible client — OpenCode, Codex, Cursor, or anything that speaks the [Model Context Protocol](https://modelcontextprotocol.io).
  6. ## How it works
  7. ```
  8. Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main Thread
  9. ```
  10. Two components:
  11. 1. **MCP Server** (this repo) — Python process that speaks MCP protocol to Claude and forwards commands over TCP
  12. 2. **Fusion360MCP Add-in** (installed in Fusion's AddIns folder) — runs inside Fusion 360, executes API calls safely on the main thread
  13. ## Prerequisites
  14. - [uv](https://docs.astral.sh/uv/) (Python package manager)
  15. - Autodesk Fusion 360
  16. - An MCP-compatible client (Claude Code, OpenCode, Codex, Cursor, etc.)
  17. ## Installation
  18. ### 1. Install the Fusion 360 Add-in
  19. **Quick install (symlink for development):**
  20. ```bash
  21. ./scripts/install-addon.sh
  22. ```
  23. **Manual install:**
  24. ```bash
  25. # macOS
  26. cp -r addon ~/Library/Application\ Support/Autodesk/Autodesk\ Fusion\ 360/API/AddIns/Fusion360MCP
  27. # Windows (PowerShell)
  28. Copy-Item -Recurse addon "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"
  29. ```
  30. Then start it in Fusion: **Shift+S → Add-Ins → Fusion360MCP → Run**
  31. You should see `[MCP] Server listening on localhost:9876` in the TEXT COMMANDS window.
  32. ### 2. Connect your MCP client
  33. The MCP server is published on [PyPI](https://pypi.org/project/fusion360-mcp-server/) — no need to clone this repo.
  34. #### Claude Code
  35. ```bash
  36. claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socket
  37. ```
  38. #### Other MCP clients
  39. The server runs over **stdio**, so any MCP-compatible client can launch it. The command is:
  40. ```
  41. uvx fusion360-mcp-server --mode socket
  42. ```
  43. <details>
  44. <summary><strong>Cursor</strong> (~/.cursor/mcp.json)</summary>
  45. ```json
  46. {
  47. "mcpServers": {
  48. "fusion360": {
  49. "command": "uvx",
  50. "args": [
  51. "fusion360-mcp-server",
  52. "--mode", "socket"
  53. ]
  54. }
  55. }
  56. }
  57. ```
  58. </details>
  59. ### Cross-machine setup (LAN)
  60. 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.
  61. **On the Fusion host** (where the add-in runs), bind to all interfaces before starting Fusion:
  62. ```powershell
  63. # Windows
  64. $env:FUSION_MCP_HOST = "0.0.0.0"
  65. ```
  66. ```bash
  67. # macOS / Linux
  68. export FUSION_MCP_HOST=0.0.0.0
  69. ```
  70. Then start Fusion and run the `Fusion360MCP` add-in. The log line `Server listening on 0.0.0.0:9876` confirms the bind.
  71. **On the MCP-server host**, point the client at the Fusion host's LAN IP:
  72. ```bash
  73. # Either via CLI flag
  74. uvx fusion360-mcp-server --mode socket --host 192.168.1.42
  75. # Or via env var (useful in MCP client configs)
  76. FUSION_MCP_HOST=192.168.1.42 uvx fusion360-mcp-server --mode socket
  77. ```
  78. **Security 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.
  79. ### 3. Verify
  80. Call the `ping` tool from your client. If it returns `{"ok": true, "status": "pong"}`, everything is connected.
  81. ### Uninstalling
  82. 1. Remove the `fusion360` entry from your MCP client config
  83. 2. Stop the add-in in Fusion (Shift+S → Add-Ins → Fusion360MCP → Stop)
  84. 3. Delete the add-in folder from Fusion's AddIns directory
  85. ## Available Tools (93)
  86. > 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).
  87. ### Scene & Query
  88. | Tool | Description |
  89. |------|-------------|
  90. | `ping` | Health check (instant, no Fusion API) |
  91. | `get_scene_info` | Design name, bodies, sketches, features, camera |
  92. | `get_object_info` | Detailed info about a named body or sketch |
  93. | `get_bounding_box` | Axis-aligned bbox (min/max/size/center) for body or component; unions all bodies when called on a component |
  94. | `list_components` | List all components in the design |
  95. ### Design Type Safety
  96. | Tool | Description |
  97. |------|-------------|
  98. | `get_design_type` | Check if design is in parametric or direct mode |
  99. | `set_design_type` | Switch design type (parametric/direct recovery) |
  100. ### Sketching
  101. | Tool | Description |
  102. |------|-------------|
  103. | `create_sketch` | New sketch on xy/yz/xz plane, optional offset |
  104. | `draw_rectangle` | Rectangle in most recent sketch |
  105. | `draw_circle` | Circle in most recent sketch |
  106. | `draw_line` | Line in most recent sketch |
  107. | `draw_arc` | Arc (center + start + sweep angle) |
  108. | `draw_spline` | Fit-point or control-point spline |
  109. | `create_polygon` | Regular polygon (3–64 sides) |
  110. | `add_constraint` | Geometric constraint (coincident, parallel, tangent, etc.) |
  111. | `auto_constrain` | **(2026+)** Auto-constrain a sketch via the AutoConstrain API — 3 result options (thorough / fast / tolerance-adjusting) |
  112. | `add_dimension` | Driving dimension (distance, angle, radial, diameter) |
  113. | `offset_curve` | Offset connected sketch curves |
  114. | `trim_curve` | Trim at intersections |
  115. | `extend_curve` | Extend to nearest intersection |
  116. | `project_geometry` | Project edges/bodies onto sketch plane |
  117. ### Features
  118. | Tool | Description |
  119. |------|-------------|
  120. | `extrude` | Extrude a sketch profile |
  121. | `revolve` | Revolve a profile around an axis |
  122. | `sweep` | Sweep a profile along a path |
  123. | `loft` | Loft between two or more profiles |
  124. | `fillet` | Round edges (all/top/bottom/vertical) |
  125. | `chamfer` | Chamfer edges |
  126. | `shell` | Hollow out a body |
  127. | `mirror` | Mirror a body across a plane |
  128. | `create_hole` | Hole feature on a body face |
  129. | `rectangular_pattern` | Pattern in rows and columns |
  130. | `circular_pattern` | Pattern around an axis |
  131. | `create_thread` | Add threads (cosmetic or modeled) |
  132. | `draft_faces` | Draft/taper faces for mold release |
  133. | `split_body` | Split a body using a plane |
  134. | `split_face` | Split faces of a body |
  135. | `offset_faces` | Push/pull faces by a distance |
  136. | `scale_body` | Scale uniformly or non-uniformly |
  137. | `suppress_feature` | Suppress a timeline feature |
  138. | `unsuppress_feature` | Re-enable a suppressed feature |
  139. ### Body Operations
  140. | Tool | Description |
  141. |------|-------------|
  142. | `move_body` | Translate a body by (x, y, z) |
  143. | `rename_body` | Rename a body (searches root and all components) |
  144. | `boolean_operation` | Join/cut/intersect two bodies |
  145. | `delete_all` | Clear the design |
  146. | `undo` | Undo last operation (with design-type safety guard) |
  147. ### Direct Primitives
  148. | Tool | Description |
  149. |------|-------------|
  150. | `create_box` | Box (via TemporaryBRepManager, history-less) |
  151. | `create_box_parametric` | History-based box: sketch rectangle + dimensions + extrude. `length`/`width`/`height` accept numbers (cm) or string expressions referencing User Parameters (e.g. `"boxL"`, `"outer - 2*wall_t"`) |
  152. | `create_cylinder` | Cylinder |
  153. | `create_sphere` | Sphere |
  154. | `create_torus` | Torus |
  155. ### Surface Operations
  156. | Tool | Description |
  157. |------|-------------|
  158. | `patch_surface` | Create a patch surface from boundary edges |
  159. | `stitch_surfaces` | Stitch surface bodies into one |
  160. | `thicken_surface` | Thicken a surface into a solid |
  161. | `ruled_surface` | Ruled surface from an edge |
  162. | `trim_surface` | Trim a surface with another body |
  163. ### Sheet Metal
  164. | Tool | Description |
  165. |------|-------------|
  166. | `create_flange` | Create a flange on an edge |
  167. | `create_bend` | Add a bend |
  168. | `flat_pattern` | Create flat pattern |
  169. | `unfold` | Unfold specific bends |
  170. ### Construction Geometry
  171. | Tool | Description |
  172. |------|-------------|
  173. | `create_construction_plane` | Offset, angle, midplane, 3-point, tangent |
  174. | `create_construction_axis` | Two-point, intersection, edge, perpendicular |
  175. | `create_ucs` | **(2026+, preview API)** User Coordinate System at a point with optional rotation |
  176. ### Assembly
  177. | Tool | Description |
  178. |------|-------------|
  179. | `create_component` | Create a sub-assembly component |
  180. | `add_joint` | Joint between two components |
  181. | `create_as_built_joint` | Joint from current positions |
  182. | `create_rigid_group` | Lock components together |
  183. ### Inspection & Analysis
  184. | Tool | Description |
  185. |------|-------------|
  186. | `measure_distance` | Minimum distance between entities |
  187. | `measure_angle` | Angle between entities |
  188. | `get_physical_properties` | Mass, volume, area, center of mass |
  189. | `create_section_analysis` | Section plane through model |
  190. | `check_interference` | Detect collisions between components |
  191. | `compare_meshes` | **(2026+)** Deviation statistics between two mesh bodies (min/max/mean/RMS, cm) — e.g. validate against a reference STL |
  192. ### Appearance
  193. | Tool | Description |
  194. |------|-------------|
  195. | `set_appearance` | Assign material appearance from library |
  196. | `set_color` | **(2026+)** Assign a flat RGB color (+ opacity) to a body |
  197. ### Parameters
  198. | Tool | Description |
  199. |------|-------------|
  200. | `get_parameters` | List all user parameters |
  201. | `create_parameter` | Create a new parameter |
  202. | `set_parameter` | Update a parameter value |
  203. | `delete_parameter` | Remove a parameter |
  204. ### Import / Export
  205. | Tool | Description |
  206. |------|-------------|
  207. | `import_mesh` | Import STL/OBJ/3MF as mesh body via `MeshBodies.add()`. Unit-aware (`mm`/`cm`/`m`/`in`/`ft`). Returns the mesh name and bounding box |
  208. | `export_stl` | Export body as STL (supports bodies inside components) |
  209. | `export_step` | Export body as STEP (supports bodies inside components) |
  210. | `export_f3d` | Export design as Fusion archive |
  211. | `export_view_sheet` | Export multi-view PNG sheet (iso/front/top/right) for visual inspection |
  212. | `export` | Unified dispatcher — routes to `export_stl`/`export_step`/`export_f3d` based on explicit `format` or file-extension inference |
  213. ### CAM / Manufacturing
  214. | Tool | Description |
  215. |------|-------------|
  216. | `cam_create_setup` | Create a manufacturing setup (milling/turning/cutting); applies stock mode/offsets |
  217. | `cam_create_operation` | Add a machining operation (face, contour, adaptive, drilling, etc.); applies stepdown/feed/speed/coolant parameters |
  218. | `cam_generate_toolpath` | Generate toolpaths for operations |
  219. | `cam_post_process` | Post-process to G-code — pass a full `.cps` path (cloud-post builds don't ship local posts) |
  220. | `cam_list_setups` | List all manufacturing setups |
  221. | `cam_list_operations` | List operations in a setup |
  222. | `cam_get_operation_info` | Get operation details (strategy, tool, parameters) |
  223. ### Code Execution
  224. | Tool | Description |
  225. |------|-------------|
  226. | `execute_code` | Run arbitrary Python in Fusion (REPL-style) |
  227. ### Perception
  228. | Tool | Description |
  229. |------|-------------|
  230. | `render_view` | Capture the active viewport as PNG (optional camera preset: iso/front/top/...). Returns an image block for visual verification |
  231. ## MCP Protocol Features
  232. - **Tool annotations** — each tool is tagged with `readOnlyHint`, `destructiveHint`, and `idempotentHint` so MCP clients can auto-approve safe operations
  233. - **Resources** — `fusion360://status`, `fusion360://design`, `fusion360://parameters` for passive state inspection
  234. - **Resource templates** — `fusion360://body/{name}`, `fusion360://component/{name}` for dynamic entity lookup
  235. - **Prompts** — `create-box`, `model-threaded-bolt`, `sheet-metal-enclosure` workflow templates
  236. - **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
  237. - **Mock mode** — `--mode mock` returns plausible test data without Fusion running (all responses include `"mode": "mock"`)
  238. ## Development
  239. ```bash
  240. uv sync --dev # install deps
  241. uv run pytest -v # run tests (363 tests)
  242. uv run ruff check # lint
  243. ```
  244. ## Notes
  245. - All Fusion API units are **centimeters** (Fusion's internal unit).
  246. - One operation per tool call. Batching multiple operations crashes the add-in.
  247. - 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.
  248. - Add-in logs to `~/fusion360mcp.log`.
  249. - 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.
  250. - Tested on Fusion 2705.1.15 (macOS arm64). Tools marked **(2026+)** need a build from 2026 or later.
  251. ## Acknowledgements
  252. Inspired by [BlenderMCP](https://github.com/ahujasid/blender-mcp) — the socket bridge architecture originated there.
  253. Also built on ideas from the existing Fusion 360 MCP ecosystem:
  254. - [ArchimedesCrypto/fusion360-mcp-server](https://github.com/ArchimedesCrypto/fusion360-mcp-server)
  255. - [Joe-Spencer/fusion-mcp-server](https://github.com/Joe-Spencer/fusion-mcp-server)
  256. - [JustusBraitinger/FusionMCP](https://github.com/JustusBraitinger/FusionMCP)
  257. - [zkbkb/fusion-mcp](https://github.com/zkbkb/fusion-mcp)
  258. - [mycelia1/fusion360-mcp-server](https://github.com/mycelia1/fusion360-mcp-server)
  259. - [sockcymbal/autodesk-fusion-mcp-python](https://github.com/sockcymbal/autodesk-fusion-mcp-python)
  260. ## License
  261. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.