kicad-copilot
KiCad Copilot is an MCP server that lets AI agents create, modify, analyze, and automate KiCad schematics and PCBs from natural language.
Component & block search: find real components by MPN or part UUID, and search reusable circuit blocks by function.
Schematic editing: add/remove/replace components, connect pins, add reused blocks, and extract/apply circuit changes to
.kicad_schfiles.Schematic beautification: reorganize selected components into named functional blocks while preserving electrical connections.
Project & document management: create KiCad projects, schematics, hierarchical pages, and empty PCBs; inspect project trees and hierarchical sheet structures.
Checkpoints: save, list, and restore exact file checkpoints for recoverable workflows.
PCB synchronization: import schematic changes into the associated
.kicad_pcbfile.PCB placement: generate mechanical previews, create board layouts via a JavaScript DSL, review PNG/SVG previews, and apply approved placement.
PCB routing: run local auto-routing with a bundled WASM router, wait/cancel routing operations, and clear existing tracks/vias while preserving placement.
Copper pours: create full-board copper zones with optional stitching vias.
PCB stack management: set copper layer counts while preserving F.Cu and B.Cu.
Design analysis: run schematic/PCB checks with optional thermal, EMC, and trace-proximity analysis; manage long-running operations via wait/cancel.
KiCad CLI integration: discover
kicad-clifor ERC, DRC, PDF/SVG exports, 3D renders, Gerber/drill generation, BOM, position, STEP/STL/GLB/VRML exports, and format upgrades.
Provides tools for creating and modifying KiCad schematics, searching components, working with hierarchical projects, generating PCB placement, routing boards locally, creating copper pours, managing checkpoints, and using kicad-cli for ERC, DRC, exports, and other native operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kicad-copilot Add a fuse and a TVS diode to the input of the power supply"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
KiCad Copilot
AI-powered MCP server for KiCad. Create and modify schematics from natural language, search real components, work with hierarchical projects, generate PCB placement, route boards locally, and create simple copper pours directly through an AI agent.
KiCad Copilot is the KiCad counterpart to EasyEDA Copilot. It provides the same core circuit-generation and PCB automation capabilities—and goes further with file-oriented hierarchical projects, recoverable checkpoints, native kicad-cli integration, and fully local PCB routing.
Integrated analysis: KiCad Copilot downloads a pinned, verified kicad-happy v2.2.0 release on first use of
analyze_schematicoranalyze_pcb. The MCP tools return compact, token-efficient actionable findings and focused design data.
What it does
KiCad Copilot gives AI agents a high-level, file-oriented interface to KiCad:
Generate and modify schematics: add, remove, replace, and connect real components without editing every KiCad object individually.
Rebuild schematic blocks: reorganize selected components while preserving their electrical connections.
Search components and reusable blocks: resolve components by MPN or part UUID and insert proven functional circuits.
Work with KiCad projects: inspect project trees and create projects, standalone schematics, hierarchical sheets, and PCB files.
Preserve recoverable checkpoints: save, list, and restore exact versions of individual KiCad files.
Synchronize schematic and PCB: explicitly import schematic changes into the associated board.
Generate PCB placement: describe board constraints in a compact JavaScript DSL, review PNG/SVG previews, and apply the approved result.
Route locally: use
eda-copilot-routerwith its managed KRT backend without sending routing work to an external service.Create copper pours: add simple full-board zones with optional stitching vias.
Use native KiCad tooling: discover
kicad-clifor ERC, DRC, previews, exports, manufacturing files, and other native operations.
KiCad Copilot works directly with saved .kicad_pro, .kicad_sch, and .kicad_pcb files. It does not require KiCad IPC or a plugin installed inside KiCad.
Related MCP server: KiCad MCP Server
Examples
These projects were generated and iterated through KiCad Copilot. The complete KiCad source files are available in the examples directory.
ATmega328P development board
A hierarchical ATmega328P design with the MCU core, clock, reset, decoupling, USB-UART power, Nano-compatible headers, and debug connections split across functional sheets.
Download the ATmega328P project
Geiger high-voltage supply
A larger multi-sheet design covering power input, 3.3 V regulation, the high-voltage generator, flyback stage, feedback, detector, controller, and user interface.
Download the Geiger high-voltage project
RP2350 development board
A hierarchical RP2350 design with power, clock, flash, USB/debug, GPIO headers, and an AI-generated PCB placement. The example includes the placement DSL and an editable KiCad board.
Installation
Add the MCP server to your AI agent.
Codex:
codex mcp add kicad-copilot -- npx -y kicad-copilot-mcpClaude Code:
claude mcp add kicad-copilot -- npx -y kicad-copilot-mcpGeneric MCP configuration:
{
"mcpServers": {
"kicad-copilot": {
"command": "npx",
"args": ["-y", "kicad-copilot-mcp"]
}
}
}Restart the MCP client after adding the server. KiCad Copilot includes local workflow documentation for the agent; tool descriptions expose its installed path automatically.
Requirements
Node.js 20 or newer
KiCad 9 or 10
Python 3 for managed EasyEDA2KiCad installation and kicad-happy analysis
KiCad Copilot searches for kicad-cli in PATH and standard KiCad installation locations, preferring KiCad 10 when multiple supported versions are installed. Set KICAD_CLI_PATH when the executable is stored elsewhere.
The first real-component conversion uses an existing EasyEDA2KiCad installation or installs it automatically into a managed local virtual environment.
The first design-analysis call downloads the pinned kicad-happy release into the shared
EDA Copilot asset cache after verifying its archive size and SHA-256 hash. Set
KICAD_HAPPY_DIR to use a trusted local checkout instead.
Schematic workflow
Ask the agent to inspect a KiCad project or give it the path to a target .kicad_sch file. A typical request can be as simple as:
Open D:\Projects\sensor\sensor.kicad_pro and add a 3.3 V regulator block to the Power sheet.The agent can inspect the project tree, read the target sheet as compact component/net JSON, find exact components, assemble the requested change, and validate the saved result through KiCad.
Hierarchical projects remain file-oriented: each physical schematic sheet is modified through its own .kicad_sch path, while project-wide context is used where the operation requires the complete signal map.
File synchronization
KiCad Copilot changes files on disk. KiCad does not reliably merge those changes with newer unsaved edits in an already open editor.
Before a write:
Save intentional changes in KiCad.
Avoid keeping the only copy of newer work in the editor buffer.
After a write:
Reload, revert, or reopen the document in KiCad.
Do not overwrite the updated file with an older editor buffer.
PCB workflow
PCB placement and routing use an explicit review flow:
Import schematic changes into the target
.kicad_pcbfile.Describe the outline, holes, constraints, regions, and important components in the placement DSL.
Generate a mechanical preview without modifying the PCB.
Review the returned PNG or SVG preview.
Generate and approve the complete placement.
Apply the stored placement to the PCB.
Route the remaining connections locally.
Inspect the result and run final KiCad DRC.
Every placement response containing a PCB is checkpointed and applied atomically, including preview and issue-bearing results. The agent inspects the returned preview or PCB analysis and can roll back through checkpoints when needed; no separate assembly tool call is required.
Placement and router DSL execution remain separate operations. This keeps schematic-to-PCB synchronization explicit and makes it possible to clear or rebuild routing without deleting placed components.
KiCad CLI
get_project_info reports the discovered kicad-cli path and version. Agents should use the native CLI whenever KiCad already provides the operation, including:
schematic ERC and PCB DRC;
schematic and PCB PDF/SVG exports;
3D PCB renders;
Gerber and drill generation;
BOM, position, STEP, STL, GLB, and VRML exports;
project jobsets and format upgrades.
See KiCad CLI workflow for ready-to-use commands.
Design analysis
analyze_schematic runs the offline schematic checks and can return focused top-level
overview, hierarchy, block, connectivity, power, bus, BOM, assembly, and verification data.
analyze_pcb automatically enriches PCB analysis from the associated schematic, runs
cross-domain checks, and optionally adds thermal, EMC, or trace-proximity analysis. Individual
boolean flags control each optional report field; compact findings are enabled by default.
Long-running PCB layout, PCB routing, and lifecycle audits return a prefixed
operation_id such as pcb-dsl:1a2b3c4d. Continue any of them with
wait_operation; stop obsolete work with cancel_operation.
The tools omit internal rule identifiers, runtime metrics, and coordinate-level copper from
the LLM response.
See design analysis for the exact compact result contract and workflow.
Compatibility
KiCad version | Status |
KiCad 10 | Supported |
KiCad 9 | Supported |
Other major versions are rejected because their file formats and CLI behavior are not covered by the current implementation.
Documentation
Development
git clone https://github.com/biosshot/kicad-copilot.git
cd kicad-copilot
npm install
npm run check
npm startRun the MCP Inspector with:
npm run inspectThe repository also contains focused schematic, PCB, and routing test scripts for development against disposable files.
License
MIT
Available Tools
22 toolsassemble_pcb_layoutAssemble PCB LayoutB
Apply a stored placement to one KiCad PCB. PCB instructions: /app/docs/pcb-layout/instructions.md
Inputs: path (required), layout_id (required).
auto_route_pcbAuto Route PCBC
Route a KiCad PCB with the bundled local WASM router and apply it atomically. PCB instructions: /app/docs/pcb-layout/instructions.md
Inputs: path (required), wait_ms, pour_gnd, stitch_gnd, +4 more.
beautify_schematicBeautify SchematicA
Reassemble selected KiCad components into named functional blocks while preserving their electrical connections. Recoverable item errors are returned (max 36). For circuit workflow docs, read: /app/docs/SKILL.md
Inputs: path (required), blocks (required).
cancel_auto_routeCancel Auto RouteA
Cancel a running local PCB auto-route operation.
Inputs: operation_id (required).
cancel_pcb_layoutCancel PCB LayoutA
Request cancellation of an active make_pcb_layout operation.
Inputs: operation_id (required).
clear_pcb_routingClear PCB RoutingA
Delete PCB tracks, track arcs, and vias while preserving placement, zones, and outline. PCB instructions: /app/docs/pcb-layout/instructions.md
Inputs: path (required), only_nets, ignore_nets.
component_searchSearch ComponentA
Search a component by exact part_uuid or MPN.
Inputs: MPN, part_uuid.
create_docCreate KiCad DocumentA
Create a KiCad project, schematic, hierarchical page, or empty PCB without overwriting files. Agent instructions: /app/docs/SKILL.md
Inputs: doc (required).
extract_circuitExtract CircuitB
Apply circuit changes to a KiCad .kicad_sch file. Every added component must include part_uuid. Recoverable item errors are returned (max 36). For circuit modification docs, read: /app/docs/SKILL.md
Inputs: path (required), rm_components (required), add_components (required), external_connect (required), +2 more.
get_pcb_component_sizesGet PCB Component SizesC
Return server placement footprint sizes and compact board estimate. PCB instructions: /app/docs/pcb-layout/instructions.md
Inputs: path (required), designators, include_all.
get_project_infoGet KiCad Project InfoB
Build KiCad project and hierarchical schematic trees from a file or directory path. Agent instructions: /app/docs/SKILL.md
Inputs: path (required).
get_schematicGet KiCad SchematicA
Get exactly one KiCad .kicad_sch file as a compact component and net list. For circuit workflow docs, read the local docs folder: /app/docs/SKILL.md
Inputs: path (required).
import_pcb_changesImport PCB ChangesC
Synchronize one KiCad PCB from its associated schematic. PCB instructions: /app/docs/pcb-layout/instructions.md
Inputs: path (required), schematic_path.
list_checkpointsList KiCad CheckpointsB
List file checkpoints saved by KiCad Copilot. Agent instructions: /app/docs/SKILL.md
Inputs: path (required), page, limit.
make_pcb_layoutMake PCB LayoutA
Create placement without changing the PCB and return PNG/SVG preview paths. PCB instructions: /app/docs/pcb-layout/instructions.md
Inputs: file (required), path (required), wait_ms.
pour_pcb_layersPour PCB LayersB
Create managed full-board copper zones and optional stitching vias. PCB instructions: /app/docs/pcb-layout/instructions.md
Inputs: net (required), path (required), layers (required), max_vias, +5 more.
restore_checkpointRestore KiCad CheckpointA
Restore one exact file checkpoint by id. Agent instructions: /app/docs/SKILL.md
Inputs: id (required), path (required).
save_checkpointSave KiCad CheckpointB
Save an exact checkpoint of one KiCad file. Agent instructions: /app/docs/SKILL.md
Inputs: path (required), description.
search_reused_blockSearch Reused BlockB
Search reusable circuit blocks by function. For circuit workflow docs, read: /app/docs/SKILL.md
Inputs: query (required), page, limit.
set_pcb_stack_layersSet PCB Stack LayersB
Set the PCB copper layer count while preserving F.Cu and B.Cu. PCB instructions: /app/docs/pcb-layout/instructions.md
Inputs: path (required), copper_layer_count (required).
wait_auto_routeWait Auto RouteB
Wait for a running local PCB auto-route operation.
Inputs: operation_id (required), wait_ms.
wait_pcb_layoutWait PCB LayoutB
Wait for an active make_pcb_layout operation and return its PNG/SVG preview paths.
Inputs: operation_id (required), wait_ms.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Each tool targets a distinct operation: schematic editing, project queries, checkpoint management, and PCB layout/routing phases. The wait/cancel pairs for long-running operations are clearly separated from the operations themselves, and no two tools appear to perform the same task.
All tool names follow a consistent verb_noun snake_case pattern (e.g., get_schematic, save_checkpoint, auto_route_pcb). Even compound verbs like auto_route and pour_pcb_layers maintain the convention, and wait_/cancel_ prefixes are systematically used for async operations.
At 22 tools, the count is on the higher end, but the server spans three major subdomains (schematic, project/checkpoints, PCB layout/routing), and each tool addresses a concrete need. The count is slightly above the 'ideal' range but not excessive for this scope.
The toolset covers schematic retrieval and modification, project inspection, checkpointing, and a full PCB workflow from layer setup to routing and copper pour. Minor gaps exist (e.g., no direct manual editing of individual tracks or component placements), but the automated workflow is well-covered and agents can work around these limitations.
Maintenance
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for creating, modifying, and analyzing KiCAD schematic files using natural language.22MIT
- AlicenseBqualityBmaintenanceAn MCP server that enables AI assistants to analyze schematics, inspect PCBs, trace connections, validate designs, and generate embedded code for KiCad projects.39188MIT
- AlicenseBqualityBmaintenanceAn MCP server providing full control over KiCad 10, enabling PCB editing, schematic editing, design data, and production output via natural language.1021MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents end-to-end control of KiCad 9+ for rule checks, manufacturing exports, production-readiness certification, and live PCB editor control.MIT