Copper Kicad MCP logo

Copper Kicad MCP

Connects AI apps to KiCad for schematic design, real parts, PCB layout, validation, rendering, and fabrication files.

Install Copper Kicad MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "copper-kicad-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "copper-kicad"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 31 tools correctly ().

Overview

copper-kicad-mcp connects AI applications to KiCad so they can create orderable circuit boards from natural-language requirements. It searches LCSC and JLCPCB parts, imports symbols and footprints, edits schematics and layouts, runs KiCad ERC and DRC, produces renders, and generates fabrication packages. Reach for it when an AI-assisted hardware workflow needs real KiCad files, manufacturable components, and JLCPCB-compatible outputs. The server runs locally and does not call a language model.

Use cases

  • Design a KiCad board from a natural-language hardware specification
  • Find stocked LCSC or JLCPCB parts and import their KiCad assets
  • Route a PCB and check it with KiCad ERC and DRC
  • Inspect board renders through an AI application
  • Generate fabrication files for a board house

Key features

  • 31 MCP tools for KiCad board design
  • LCSC and JLCPCB part search with symbol and footprint import
  • PCB placement, routing, pours, length matching, and differential pairs
  • KiCad ERC and DRC validation
  • Schematic, layer, and ray-traced 3D renders
  • Gerber, drill, BOM, and placement file generation

Tools31

What Copper Kicad MCP lets your agent do. Expand a tool for its parameters.

Verified live~12.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

What it can do

From the 31 tools this server returned when we ran it; 31 declare their own safety hints.

Can delete or modify data · 8Handles credentials · 1Makes network requests · 8Read-only tools · 23
Network at startup3 connections
Files written at startup30
Install scriptsNone
npm provenanceNot published
Package age3 days
Maintainers1

Observed 2026-11-16 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 19h ago via OSV.dev · copper-kicad (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars101Stargazers on the source repository.
Last commit1d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed31Callable tools this server registers over MCP.

How Copper Kicad MCP works

What copper-kicad-mcp does

copper-kicad-mcp gives an MCP-compatible AI application access to a KiCad-based electronics design workflow. It can turn a request such as a USB-C ESP32-C3 board specification into connected schematic nets, selected components, a PCB layout, validation results, visual renders, and manufacturing files.

The workflow uses named pins and nets rather than coordinate-based connections. Parts can be found through LCSC and JLCPCB searches, with symbols, footprints, and available EasyEDA 3D models imported into the project. Fabrication output includes Gerbers, drill data, a bill of materials, and placement files.

How it works

The package runs on the user's machine and connects to a locally installed KiCad 10 installation. An AI application invokes Copper's MCP tools; the model itself remains part of that AI application, because Copper does not make language-model calls.

After design changes, KiCad's electrical rules check and design rules check can be run again. The workflow also supports component placement, PCB routing, copper pours, differential pairs, length matching, width classes, and Freerouting. Schematic, board-layer, and ray-traced 3D renders can be returned to the model for inspection.

Copper accesses the internet for component searches and downloads, update checks during setup or diagnosis, and optional autorouting dependencies. Designs remain on the local machine, and the project reports no telemetry.

Setup and configuration

KiCad 10 is required. For Node-based installation, run:

Terminal
npx -y copper-kicad setup

This route requires Node.js 18 or newer. The setup process locates KiCad, carries over libraries and settings, connects configured AI applications, and performs a test call. It asks for confirmation before each step and backs up changes. A demonstration mode is available with npx -y copper-kicad setup --demo, while npx -y copper-kicad doctor helps identify setup fixes.

Windows users can install through the Copper setup executable or the PowerShell installer. macOS and Linux provide a shell installer. Claude Desktop can use the downloadable MCP bundle, and Claude Code can be installed through its marketplace and plugin commands. Cursor, VS Code, Windsurf, Codex, and Zed can use the npx setup route or an MCP configuration containing the copper-kicad command.

The optional COPPER_NO_UPDATE_CHECK=1 setting disables KiCad update checks performed by setup and doctor.

Tools and capabilities

Copper exposes 31 MCP tools covering the board-design workflow, including:

  • Creating and editing schematics with named net connections
  • Searching LCSC and JLCPCB for stocked parts
  • Importing symbols, footprints, and available 3D models
  • Placing components and routing PCBs
  • Applying length matching, differential-pair routing, width classes, and copper pours
  • Running KiCad ERC and DRC checks
  • Generating schematic, layer, and ray-traced 3D renders
  • Producing Gerbers, drill files, BOMs, and placement files for JLCPCB, PCBWay, OSH Park, or generic fabrication

Limitations and notes

Windows is tested end to end. The macOS and Linux installation paths are newer. Autorouting can download Freerouting and a Java runtime from GitHub and Adoptium, using about 120 MB once requested. The npx launcher may install Pillow from PyPI when KiCad's Python environment lacks it; the one-line installers also fetch uv, a Python 3.12 build, and Pillow.

Copper is an independent project and is not affiliated with KiCad, LCSC, JLCPCB, or other named vendors.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Copper Kicad MCP

copper-kicad-mcp is an MCP server that connects AI applications to KiCad for electronics design. Its main tools create schematics, search LCSC and JLCPCB parts, place and route PCBs, run KiCad ERC and DRC checks, return renders, and generate Gerbers, drill files, BOMs, and placement files for fabrication.

Install KiCad 10 first, then run `npx -y copper-kicad setup` with Node.js 18 or newer. Windows also has a setup executable and PowerShell installer; Claude Desktop has an MCP bundle, and Claude Code has marketplace plugin commands.

Yes, copper-kicad-mcp works with Cursor through the setup command or an MCP configuration using `npx -y copper-kicad`. The installation instructions also provide a direct Cursor installation link.

Yes, copper-kicad-mcp generates Gerbers, drill files, BOMs, and placement files for JLCPCB. It can also generate output for PCBWay, OSH Park, or generic fabrication workflows.

No, Copper does not call a language model and keeps designs on the local machine. It connects online for part searches and downloads, KiCad update checks, and optional Freerouting and Java dependencies.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCopper Kicad MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/copper-kicad-mcp?style=directory)](https://allmcps.com/mcp/copper-kicad-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/copper-kicad-mcp"><img src="https://allmcps.com/api/badge/copper-kicad-mcp?style=directory" alt="Copper Kicad MCP on AllMCPs" /></a>