Fusion360 MCP Server
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.
How it works
Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main Thread
Two 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
Prerequisites
- uv (Python package manager)
- Autodesk Fusion 360
- An MCP-compatible client (Claude Code, OpenCode, Codex, Cursor, etc.)
Installation
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 — 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
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"fusion360": {
"command": "uvx",
"args": [
"fusion360-mcp-server",
"--mode", "socket"
]
}
}
}
3. Verify
Call the ping tool from your client. If it returns {"pong": true}, everything is connected.
Uninstalling
- Remove the
fusion360entry 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
Available Tools (80)
Scene & Query
| Tool | Description |
|---|---|
ping |
Health check (instant, no Fusion API) |
get_scene_info |
Design name, bodies, sketches, features, camera |
get_object_info |
Detailed info about a named body or sketch |
list_components |
List all components in the design |
Sketching
| Tool | Description |
|---|---|
create_sketch |
New sketch on xy/yz/xz plane, optional offset |
draw_rectangle |
Rectangle in most recent sketch |
draw_circle |
Circle in most recent sketch |
draw_line |
Line in most recent sketch |
draw_arc |
Arc (center + start + sweep angle) |
draw_spline |
Fit-point or control-point spline |
create_polygon |
Regular polygon (3–64 sides) |
add_constraint |
Geometric constraint (coincident, parallel, tangent, etc.) |
add_dimension |
Driving dimension (distance, angle, radial, diameter) |
offset_curve |
Offset connected sketch curves |
trim_curve |
Trim at intersections |
extend_curve |
Extend to nearest intersection |
project_geometry |
Project edges/bodies onto sketch plane |
Features
| Tool | Description |
|---|---|
extrude |
Extrude a sketch profile |
revolve |
Revolve a profile around an axis |
sweep |
Sweep a profile along a path |
loft |
Loft between two or more profiles |
fillet |
Round edges (all/top/bottom/vertical) |
chamfer |
Chamfer edges |
shell |
Hollow out a body |
mirror |
Mirror a body across a plane |
create_hole |
Hole feature on a body face |
rectangular_pattern |
Pattern in rows and columns |
circular_pattern |
Pattern around an axis |
create_thread |
Add threads (cosmetic or modeled) |
draft_faces |
Draft/taper faces for mold release |
split_body |
Split a body using a plane |
split_face |
Split faces of a body |
offset_faces |
Push/pull faces by a distance |
scale_body |
Scale uniformly or non-uniformly |
suppress_feature |
Suppress a timeline feature |
unsuppress_feature |
Re-enable a suppressed feature |
Body Operations
| Tool | Description |
|---|---|
move_body |
Translate a body by (x, y, z) |
boolean_operation |
Join/cut/intersect two bodies |
delete_all |
C |
Tools 5
pingHealth check (instant, no Fusion API)get_scene_infoDesign name, bodies, sketches, features, cameracreate_sketchNew sketch on xy/yz/xz plane, optional offsetextrudeExtrude a sketch profilemove_bodyTranslate a body by (x, y, z)