AI assistants · MCP

Use ArgilCAD from your own AI

Claude, Codex, Gemini, Cursor or VS Code design the part, build it in your ArgilCAD window, check how it looks and export STEP, STL or 3MF — on your own AI subscription, using no ArgilCAD credits.

Starter or Pro planArgilCAD open: desktop app or web browserNode.js 18+ for CLIs and editors

Claude Desktop

With your Claude plan

Download extension (.mcpb)

Downloads
.mcpb
argilcad.mcpb254 KB
✓
1
Download the ArgilCAD extension (.mcpb).
Claude
A
Install the ArgilCAD extension?argilcad.mcpb
CancelInstall
2
Open the file: Claude Desktop shows an install window — click Install. No Node.js needed.
ArgilCADAI assistant
3
Turn on AI assistant in ArgilCAD’s top bar: it turns green once your client is connected.
Claude
A 40 mm L-bracket with two M6 holes, please
argilcadcreate_project✓
argilcadrun_code✓
argilcadrender_view✓
4
Ask for a part — e.g. “a 40 mm L-bracket with two M6 holes”. Your AI opens a project, builds the part, looks at it and fixes what is off.

Claude Code

With your Claude plan

Terminal
$ claude mcp add argilcad -- npx -y argilcad-mcp
✓ argilcad added
1
Run the command in a terminal (needs Node.js 18 or newer).
claude
› /mcp
✓ argilcad · connected · 11 tools
2
Start claude: /mcp lists argilcad.
ArgilCADAI assistant
3
Turn on AI assistant in ArgilCAD’s top bar: it turns green once your client is connected.
Claude Code
A 40 mm L-bracket with two M6 holes, please
argilcadcreate_project✓
argilcadrun_code✓
argilcadrender_view✓
4
Ask for a part — e.g. “a 40 mm L-bracket with two M6 holes”. Your AI opens a project, builds the part, looks at it and fixes what is off.

claude mcp add argilcad -- npx -y argilcad-mcp

Codex

With your ChatGPT plan (Codex)

Terminal
$ codex mcp add argilcad -- npx -y argilcad-mcp
✓ argilcad added
1
Run the command in a terminal (needs Node.js 18 or newer).
~/.codex/config.toml
[mcp_servers.argilcad]
command = "npx"
args = ["-y", "argilcad-mcp"]
tool_timeout_sec = 180
2
A long build can outlast Codex’s 60-second default: put tool_timeout_sec = 180 under [mcp_servers.argilcad] in ~/.codex/config.toml, as below.
codex
› /mcp
✓ argilcad · connected · 11 tools
3
Start codex: /mcp lists argilcad.
ArgilCADAI assistant
4
Turn on AI assistant in ArgilCAD’s top bar: it turns green once your client is connected.
Codex
A 40 mm L-bracket with two M6 holes, please
argilcadcreate_project✓
argilcadrun_code✓
argilcadrender_view✓
5
Ask for a part — e.g. “a 40 mm L-bracket with two M6 holes”. Your AI opens a project, builds the part, looks at it and fixes what is off.

codex mcp add argilcad -- npx -y argilcad-mcp

[mcp_servers.argilcad]
command = "npx"
args = ["-y", "argilcad-mcp"]
tool_timeout_sec = 180

Gemini CLI

With your Google account

Terminal
$ gemini mcp add -s user argilcad npx -- -y argilcad-mcp
✓ argilcad added
1
Run the command in a terminal (needs Node.js 18 or newer).
gemini
› /mcp
✓ argilcad · connected · 11 tools
2
Start gemini: /mcp lists argilcad.
ArgilCADAI assistant
3
Turn on AI assistant in ArgilCAD’s top bar: it turns green once your client is connected.
Gemini CLI
A 40 mm L-bracket with two M6 holes, please
argilcadcreate_project✓
argilcadrun_code✓
argilcadrender_view✓
4
Ask for a part — e.g. “a 40 mm L-bracket with two M6 holes”. Your AI opens a project, builds the part, looks at it and fixes what is off.

gemini mcp add -s user argilcad npx -- -y argilcad-mcp

Cursor

With your Cursor plan

Add to CursorOpens Cursor. If nothing happens, install Cursor first, or paste the configuration below.

Cursor
A
Install MCP server “argilcad”?npx -y argilcad-mcp
CancelInstall
1
Click Add to Cursor and confirm the install in Cursor.
~/.cursor/mcp.json
{
"mcpServers": {
"argilcad": {
"command": "npx",
"args": ["-y", "argilcad-mcp"]
}
}
}
2
Or paste the configuration below into ~/.cursor/mcp.json.
ArgilCADAI assistant
3
Turn on AI assistant in ArgilCAD’s top bar: it turns green once your client is connected.
Cursor · Agent
A 40 mm L-bracket with two M6 holes, please
argilcadcreate_project✓
argilcadrun_code✓
argilcadrender_view✓
4
Ask for a part — e.g. “a 40 mm L-bracket with two M6 holes”. Your AI opens a project, builds the part, looks at it and fixes what is off.

{
  "mcpServers": {
    "argilcad": {
      "command": "npx",
      "args": ["-y", "argilcad-mcp"]
    }
  }
}

VS Code

With GitHub Copilot

Add to VS CodeOpens VS Code. If nothing happens, install VS Code first, or paste the configuration below.

VS Code
A
Install MCP server “argilcad”?npx -y argilcad-mcp
CancelInstall
1
Click Add to VS Code and confirm the install in VS Code.
Terminal
$ code --add-mcp '{"name":"argilcad","command":"npx","args":["-y","argilcad-mcp"]}'
✓ argilcad added
2
Or run the command below; ArgilCAD’s tools then appear in Copilot’s Agent mode.
ArgilCADAI assistant
3
Turn on AI assistant in ArgilCAD’s top bar: it turns green once your client is connected.
Copilot · Agent
A 40 mm L-bracket with two M6 holes, please
argilcadcreate_project✓
argilcadrun_code✓
argilcadrender_view✓
4
Ask for a part — e.g. “a 40 mm L-bracket with two M6 holes”. Your AI opens a project, builds the part, looks at it and fixes what is off.

code --add-mcp '{"name":"argilcad","command":"npx","args":["-y","argilcad-mcp"]}'

Other

Windsurf, Cline, Zed and other MCP clients

mcp.json
{
"mcpServers": {
"argilcad": {
"command": "npx",
"args": ["-y", "argilcad-mcp"]
}
}
}
1
Add this server to your client’s MCP configuration (needs Node.js 18 or newer).
ArgilCADAI assistant
2
Turn on AI assistant in ArgilCAD’s top bar: it turns green once your client is connected.
Other
A 40 mm L-bracket with two M6 holes, please
argilcadcreate_project✓
argilcadrun_code✓
argilcadrender_view✓
3
Ask for a part — e.g. “a 40 mm L-bracket with two M6 holes”. Your AI opens a project, builds the part, looks at it and fixes what is off.

{
  "mcpServers": {
    "argilcad": {
      "command": "npx",
      "args": ["-y", "argilcad-mcp"]
    }
  }
}

How it works

1

Your AI thinks

Your assistant plans the part and prepares the model, on your own AI subscription.

2

ArgilCAD builds

The connector hands it to your open ArgilCAD, which builds it on your computer and shows it.

3

Check, undo, export

Every run is a step in your timeline. The AI looks at renders, fixes its errors and exports.

Questions

Does it use ArgilCAD credits?

No. Your AI does the thinking on your own subscription, and the CAD runs on your computer.

Which plan do I need?

Connecting an AI assistant comes with Starter and Pro. See plans.

Does ArgilCAD have to be open?

Yes — the desktop app, or argildesign.com/argilcad in a web browser on a computer. Open a project, or let your assistant create one.

Why doesn’t it work in Safari?

Safari does not let a website talk to programs on your own computer, and the connector your AI starts is such a program. Other browsers allow it. In Safari, use the ArgilCAD desktop app instead.

Can I use ChatGPT, Claude or Grok in the browser?

Not yet: web chats only reach connectors hosted on the internet. Use Codex with a ChatGPT plan, Claude Desktop or Claude Code with a Claude plan, or Gemini CLI with a Google account.

Where does my design go?

From ArgilCAD to the AI client you connected, and from there to that AI’s provider, under its terms. Nothing goes to ArgilCAD’s servers.

Two assistants at once?

Yes. Claude Desktop and Codex, say, can both be connected; each takes its own slot.