Fusion360 MCP Server

Connects AI coding agents to Autodesk Fusion 360 for CAD automation

README.md

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:

  1. MCP Server (this repo) — Python process that speaks MCP protocol to Claude and forwards commands over TCP
  2. 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

  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

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, camera
create_sketchNew sketch on xy/yz/xz plane, optional offset
extrudeExtrude a sketch profile
move_bodyTranslate a body by (x, y, z)

Try it

Create a new sketch on the XY plane and draw a 50mm by 50mm rectangle.
Extrude the current sketch profile by 20mm.
List all components currently in the design.
Move the main body by 10mm along the X-axis.
Create a circular pattern of the selected feature around the Z-axis.

Frequently Asked Questions

What are the key features of Fusion360 MCP Server?

Natural language control over CAD sketching and 3D modeling. Supports over 80 tools for geometry creation and assembly management. Executes API calls safely on the Fusion 360 main thread. Compatible with Claude Code, Cursor, and other MCP clients. Supports CAM operations and parameter management.

What can I use Fusion360 MCP Server for?

Automating repetitive 3D modeling tasks via natural language prompts. Generating complex geometric sketches from descriptive text. Programmatically modifying existing CAD designs using AI agents. Streamlining CAD workflows by integrating AI into the design process.

How do I install Fusion360 MCP Server?

Install Fusion360 MCP Server by running: claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socket

What MCP clients work with Fusion360 MCP Server?

Fusion360 MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Fusion360 MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare