Back to Browse

Tinkercad Circuits MCP Server

Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Builds and simulates Arduino breadboard circuits in Tinkercad Circuits.

About

Builds and simulates Arduino breadboard circuits in Tinkercad Circuits.

Security Report

5.2
Moderate5.2Moderate Risk

The server is a Playwright-driven automation bridge that edits Tinkercad Circuits designs through the editor's internal JavaScript model. It validates design URLs to tinkercad.com, validates inputs with zod, and has no hardcoded secrets, shell execution, or data exfiltration paths in the reviewed code. The main concerns are that it relies on undocumented editor internals, stores a persistent logged-in browser profile on disk, and the truncated spec.ts could not be fully reviewed. Supply chain analysis found 6 known vulnerabilities in dependencies (0 critical, 4 high severity). Package verification found 1 issue.

8 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

process_spawn

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "tinkercad-circuits-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tinkercad-circuits-mcp@0.1.0"
      ]
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

tinkercad-circuits-mcp

An MCP server that builds Arduino circuits in Tinkercad Circuits and runs them in the simulator. You describe the circuit (which part goes in which breadboard hole, the wires, the sketch) and it appears in your Tinkercad account, wired on a breadboard, with the code saved. It can then start the simulation, press buttons, type into the Serial Monitor and tell you what the LEDs, servos and serial output did.

It works with Claude Code, Claude Desktop, Cursor, Codex and any other client that speaks the Model Context Protocol.

The server builds a traffic light on an empty breadboard, then runs it in the Tinkercad simulator: green, yellow, red

examples/traffic-light.json, built and simulated by the server. The LEDs are read back from the simulator to check the order.

I wrote it to get through a course with 70-odd Arduino lab tasks that all had to be handed in as Tinkercad designs. Building them by hand took forever.

If you found sethski/tinkercad-mcp-server first: that one works by clicking and dragging in the editor. When I tried it in November 2026 it could not create a circuit or find the breadboard in the parts panel, and it had no way of knowing which hole a leg ended up in. This server changes the editor's circuit model directly, so parts land in the holes you name, and it reads the result back and checks it in the simulator.

Not affiliated with Autodesk. Tinkercad has no public API for Circuits; this uses the editor's internals, which can change without notice. See How it works.

What it can do

  • Create or open a design and build a whole circuit in one call: Arduino Uno, small breadboard, parts in the holes you name, colour-coded jumper wires routed around the board.
  • Write the Arduino sketch into the design.
  • Read a design back: every part, the hole under each pin, its settings, every wire, the code.
  • Run the simulator and sample LED brightness, servo angles and the Serial Monitor at the times you choose, while pressing buttons or sending serial input.
  • Change a setting between runs, like a potentiometer position or the distance an ultrasonic sensor sees, to test different inputs.

About 20 parts are supported: LEDs, resistors, buttons, potentiometers, servos, a piezo, the HC-SR04, TMP36, DC motors (with and without encoder), the L293D, an IR receiver, an RGB LED and a few more. The full list is in docs/parts.md.

Setup

You need Node.js 20 or newer and Google Chrome.

Claude Code

Install it as a plugin. That adds the MCP server and the skill in one go:

/plugin install tinkercad-circuits --marketplace netchuu/tinkercad-circuits-mcp

From a shell: claude plugin marketplace add netchuu/tinkercad-circuits-mcp and then claude plugin install tinkercad-circuits@tinkercad-circuits-mcp.

If you only want the server: claude mcp add tinkercad-circuits -- npx -y tinkercad-circuits-mcp.

Codex

In ~/.codex/config.toml:

[mcp_servers.tinkercad-circuits]
command = "npx"
args = ["-y", "tinkercad-circuits-mcp"]

and the skill:

mkdir -p ~/.codex/skills/tinkercad-circuits
curl -fsSL https://raw.githubusercontent.com/netchuu/tinkercad-circuits-mcp/main/skills/tinkercad-circuits/SKILL.md -o ~/.codex/skills/tinkercad-circuits/SKILL.md

Claude Desktop, Cursor and other clients

Add this to the client's MCP config: claude_desktop_config.json for Claude Desktop, ~/.cursor/mcp.json for Cursor.

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

Sign in to Tinkercad

Once, whichever client you use:

npx -y tinkercad-circuits-mcp login

This opens Chrome on the Tinkercad page. Sign in the way you normally do; it is an ordinary Chrome window. It closes once you reach your dashboard. The session lives in ~/.tinkercad-circuits-mcp/profile; your password never passes through this project.

Restart your client afterwards so it picks up the server.

Let your agent set it up

You can hand the setup to Claude Code or Codex:

Set up the Tinkercad Circuits MCP server from https://github.com/netchuu/tinkercad-circuits-mcp, following its README.

The agent can do everything except signing in. It should run npx -y tinkercad-circuits-mcp login and ask you to sign in in the Chrome window that opens; then, after a restart, tinkercad_status should report signedIn: true.

From source

git clone https://github.com/netchuu/tinkercad-circuits-mcp.git
cd tinkercad-circuits-mcp
npm install
npm run build
npm run login

and use node /full/path/to/tinkercad-circuits-mcp/dist/index.js as the command in the configs above.

Using it

Ask for a circuit in plain words:

Build a traffic light in Tinkercad: red, yellow and green LEDs on pins 10, 9 and 8, green for 5 s, yellow 2 s, red 5 s. Then run it and check the order.

Claude turns that into a spec for tinkercad_build_circuit. A smaller one, a single blinking LED, looks like this:

{
  "title": "Blink an LED on a breadboard",
  "parts": [
    { "ref": "r1", "type": "resistor", "at": "5g", "pin": "1", "angle": 90, "props": { "ohms": 220 } },
    { "ref": "led1", "type": "led", "at": "9i", "pin": "anode", "angle": 180 }
  ],
  "wires": [["uno.GND1", "T-1"], ["uno.D13", "5i"], ["10h", "T-10"]],
  "code": "void setup() { pinMode(13, OUTPUT); }\nvoid loop() { digitalWrite(13, HIGH); delay(1000); digitalWrite(13, LOW); delay(1000); }"
}

The resistor spans columns 5 to 9 in row g, the LED's anode shares column 9 and its cathode goes to the ground rail. The format is explained in docs/circuit-spec.md, and there are more complete circuits in examples/.

To check the circuit, Claude calls tinkercad_simulate:

{ "samples_ms": [500, 1500, 2500], "leds": ["led1"] }

and gets back, for each sample, whether led1 was on and the simulator clock at that moment.

Tools

ToolWhat it does
tinkercad_statusChecks that the Chrome profile is signed in to Tinkercad.
tinkercad_list_partsParts, pin names and settings.
tinkercad_open_circuitOpens a design by link or id, or creates a new one.
tinkercad_build_circuitReplaces the open circuit with the one in the spec and saves the code.
tinkercad_get_circuitReads the saved circuit back.
tinkercad_set_codeReplaces the sketch.
tinkercad_set_partChanges a part setting (knob position, sensor distance).
tinkercad_simulateRuns the simulator with button presses and serial input; returns LED, servo and serial readings.
tinkercad_screenshotReturns a picture of the editor.

Limits

  • One small breadboard per circuit, Arduino Uno only.
  • Tinkercad has no KY-023 joystick, LM35, HC-05 Bluetooth module, L298N or IR line sensor. The skill lists the usual stand-ins (two potentiometers, TMP36, the Serial Monitor, L293D, pushbuttons).
  • The simulator runs slower than real time, and LED readings come from a screenshot, so leave some margin in your timings. Hold buttons for at least 0.6 s.
  • Only one process can use the Chrome profile at a time.
  • If Tinkercad changes its editor internals, building will fail until the code is updated. npm run smoke tells you quickly whether it still works.

Documentation

Development

npm test          # unit tests for the spec and catalog, no browser needed
npm run smoke     # builds and simulates two circuits in your Tinkercad account
npm run parts-doc # regenerates docs/parts.md

The smoke test creates a design called "tinkercad-circuits-mcp smoke test". Pass its link to reuse it: npm run smoke -- https://www.tinkercad.com/things/<id>.

Issues and pull requests are welcome, especially new parts. Adding one is mostly finding its device id (the data-did attribute on the tile in Tinkercad's parts panel) and its pin names; How it works has the details.

License

MIT

Reviews

No reviews yet

Be the first to review this server!