How to connect an assistant to Sawdust

Published on October 18, 2026

Connect Claude, ChatGPT, Cursor, Claude Code, Codex, or another MCP client to https://sawdust.diy/mcp with OAuth sign-in.

Sawdust exposes a remote Model Context Protocol (MCP) server at https://sawdust.diy/mcp. Once connected, your external assistant can list your projects, inspect 3D geometry and cut sheets, run woodworking tools, and save procedures directly on your Sawdust account.

Use https://sawdust.diy/mcp in any MCP client that supports remote HTTP servers and OAuth.

Copy the server URL in Sawdust

Open Add your own AI agent from the Chat panel (or open Settings and scroll to Connected assistants) and switch to Connect Claude or ChatGPT. Click Copy next to https://sawdust.diy/mcp.

{
  "mcpServers": {
    "sawdust": {
      "url": "https://sawdust.diy/mcp"
    }
  }
}

Sawdust Your AI agent dialog showing the Connect Claude or ChatGPT tab, the https://sawdust.diy/mcp URL, and the Claude Code CLI command.

Pick your assistant

Follow the setup guide for the assistant you use:

Claude (claude.ai and Claude Desktop): Settings -> Connectors -> Add custom connector.
Claude Code: claude mcp add --transport http sawdust https://sawdust.diy/mcp, then run /mcp.
OpenAI Codex CLI: codex mcp add sawdust --url https://sawdust.diy/mcp.
ChatGPT: Settings -> Connectors (with developer mode enabled) -> Add custom connector.
Cursor: Settings -> Tools & Integrations -> New MCP server.
Google Antigravity: Add serverUrl in mcp_config.json and complete the browser handoff.
Hermes Agent: hermes mcp add sawdust https://sawdust.diy/mcp --auth oauth.
Command Code: cmdcode mcp add --transport http sawdust https://sawdust.diy/mcp.
Zed: Agent Panel -> MCP Servers -> Add Custom Server.

Approve access on the consent screen

When your assistant connects for the first time, it opens a browser tab to Sawdust. Sign in if prompted, review the requested permissions, and click Approve:

Read your projects (projects:read): View project steps, materials, cut sheets, and 3D scene state.
Create and edit your projects (projects:write): Add stock, run cuts and fasteners, and update project layouts.
Create and edit your saved procedures (procedures:write): Save and update reusable parametric procedures in your library.

Sawdust OAuth consent screen asking to connect Claude with projects:read, projects:write, and procedures:write permissions.

Manage or disconnect an assistant

Every authorized assistant appears in Settings -> Connected assistants with its granted scopes, connection date, and last-used date. Click Disconnect at any time to revoke its tokens immediately.