kicad-mcp

This tool enables your AI agent to use KiCad — the industry-standard open-source electronics design software — to design circuits and lay out printed circuit boards for you.

What This Does

You describe what you need — "design a board for this ESP32 circuit" or "here's the schematic, lay out the PCB" — and your AI agent does the rest: drawing the schematic, choosing components, placing them on the board, routing traces, checking for errors, and producing manufacturing-ready files. All using the same KiCad that professional engineers use, with 17 tools covering the full design workflow.

You don't need to know KiCad. You don't need to know what a PCB layout tool does. You just need an AI agent (like Claude).

Getting Started

Tell your AI agent:

Go to https://github.com/blwfish/kicad-mcp and read the AGENT-INSTALL.md file. Follow the instructions to install and configure the KiCad MCP server on this machine.

Your agent will handle the rest — installing prerequisites, cloning the repo, downloading the autorouter, and registering itself. Once setup is complete, you can ask your agent to design PCBs.

For best results: Use Claude Opus (not Haiku or Sonnet) with the ability to spawn subagents. For autorouting, use FreeRouter v2.2.4+ — v2.2.3+ is 10–30× faster than v2.1.0 and deterministic; see AGENT-INSTALL.md for details. The combination of a capable model and parallel exploration (component research, placement suggestions) dramatically improves PCB design workflows. Claude Code provides automatic prompt caching that speeds up iterative design tasks.

Client compatibility: kicad-mcp exposes 17 tools, well within every known MCP client limit. Claude Code, Cursor, and Gemini are all supported. Claude Code is recommended for its automatic prompt caching and subagent support.

What You Can Ask Your Agent To Do

• Design a PCB from a description — "I need a board with an ATmega328, three LEDs, and a USB-C connector"
• Lay out a PCB from a schematic — "Here's my schematic, create the board layout and route it"
• Modify an existing board — "Move the voltage regulator closer to the connector and re-route"
• Check a design — "Run DRC on my board and fix any issues"
• Prepare for manufacturing — "Panelize this board 2x5 with V-scores and generate the files"

The agent knows the full workflow — schematic → board sizing → component placement → routing → copper zones → verification — and will walk through it step by step.

See docs/examples/ for real boards designed this way — prompt, schematic, and routed PCB.

Background

I built this because I need it. I'm not an electrical engineer — I build things for my model railroad that need custom PCBs, and I can't design circuits without this tool and Claude. This is how I actually get boards made: I describe what I need, Claude drives KiCad through this server, and I send the Gerbers to fab. It's not a demo or a hackathon project.

That means reliability matters. The test suite (2,000+ tests) exists because I depend on this working correctly when I sit down to design a board. Bugs in PCB layout tools turn into real problems — wrong footprints, shorted traces, boards that don't work when they arrive from the manufacturer.

I use Claude Code on a Mac. Other platforms should work — the code handles macOS, Windows, and Linux — but are untested. PRs for other agents and platforms will be considered.