KiCad_MCP
Provides tools for KiCad 10 projects, including schematic analysis, netlist connectivity tracing, ERC/DRC validation, manufacturing exports, PCB inspection and editing, and live IPC editing of the board open in KiCad.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
KiCad_MCP
MCP (Model Context Protocol) server for KiCad 10, built on the official
kicad-python bindings and kicad-cli. One server covers the whole
design-to-order loop: schematic analysis, netlist connectivity, ERC/DRC
validation, transactional PCB and schematic editing, library search, mechanical
and manufacturing checks, live IPC editing of the open board, and vendor part
search / BOM purchase lists (DigiKey Korea, IC Mart, DeviceMart).
Repository: https://github.com/skfine24/KiCad_MCP
Current release: v0.8.1 — 91 tools, 4 resources. v0.8.1 is a maintenance release (UTF-8 enforcement, dead-code cleanup, standalone parts server removed); the feature set is the same as v0.8.0.
What's new in v0.8.0
The former standalone parts-purchase MCP server is merged into this package.
There is no second process and no second opencode entry; part search and BOM
purchasing are regular tools here.
Vendor search:
search_parts,search_digikey,search_icmart,search_devicemart,compare_parts,get_partand per-site product lookups. DigiKey Korea returns KRW price tiers, stock, MOQ/order multiple and the exact DigiKey product number (Product Information V4 API).BOM purchasing:
bom_purchase_listprices BOM items against DigiKey/IC Mart/DeviceMart and recommends the cheapest available option;check_digikey_bomstrictly requires an exact MPN or DigiKey product number for every non-module item.DeviceMart guest cart:
add_to_cart_devicemart,get_devicemart_cart,remove_from_cart_devicemart. No login, no checkout automation; the cart survives restarts via a persisted cookie file.Modules (Pico/Pico W, VL53L0X/L1X/L5CX, TTP223 module, WS2812B strip) are excluded from the purchase BOM by default (
include_modules=Trueto include them). KiCad BOM files are never modified by these tools.Network tools are annotated
openWorldHint; no request is made until a tool is called.
Everything from v0.6.0/v0.7.0 is unchanged: fresh netlists, structured DRC/ERC,
transactional pcb_batch, schematic text editing, library search, mechanical
checks and manufacturing manifests.
Related MCP server: KiCAD MCP Server
Requirements
KiCad 10.0.x (tested with 10.0.8, API 10.0.6)
Python 3.11+
uv/uvxfor the one-command install (orpip)For live IPC: KiCad GUI running with Preferences > Plugins > Enable KiCad API server on, and a PCB editor document open
For DigiKey search: an API credential file (see below). IC Mart and DeviceMart need no credentials.
Installation
opencode (recommended)
Add this to ~/.config/opencode/opencode.jsonc:
{
"mcp": {
"kicad": {
"type": "local",
"command": [
"uvx",
"--from",
"git+https://github.com/skfine24/KiCad_MCP.git@v0.8.1",
"kicad-mcp"
],
"enabled": true
}
}
}Restart opencode. uvx builds the package from the tagged GitHub source and
caches the environment; no local clone or virtualenv is required. Use @main
instead of @v0.8.1 to track the latest commits.
If you previously had a separate parts MCP entry, remove it — v0.8.1 replaces
it.
Install as a tool
uv tool install git+https://github.com/skfine24/KiCad_MCP.git@v0.8.1
kicad-mcppip
pip install "kicad-mcp @ git+https://github.com/skfine24/KiCad_MCP.git@v0.8.1"Local development
git clone https://github.com/skfine24/KiCad_MCP.git
cd KiCad_MCP
uv venv
uv pip install -e ".[dev]"
.\.venv\Scripts\python.exe -m kicad_mcpWindows note: an editable install on a network share whose path contains
non-ASCII characters can make Python fail while reading the generated .pth
file (UnicodeDecodeError: 'cp949' codec ...). Clone to a local ASCII path for
development; the uvx install is unaffected because it builds a wheel.
Source encoding: all source, test and documentation files are UTF-8 without BOM.
.editorconfig sets charset = utf-8, and tests/test_encoding.py fails the
suite if any file is not valid UTF-8.
Vendor part search setup
DigiKey credentials are read from
C:\Users\skfin\.config\opencode\parts-purchase\digikey.json by default
(outside the repository):
{
"client_id": "...",
"client_secret": "...",
"customer_id": "..."
}Override the path with PARTS_MCP_DIGIKEY_CREDENTIALS. The file must not be
committed.
DeviceMart guest-cart cookies are persisted in
C:\Users\skfin\.config\opencode\parts-purchase\state\devicemart_cookies.json
so the cart survives server restarts. Override the directory with
KICAD_MCP_PARTS_STATE_DIR.
Tools (91)
Category | Tools |
Project |
|
Schematic analysis |
|
Connectivity |
|
Validation |
|
PCB inspection |
|
PCB editing |
|
Schematic editing |
|
Library |
|
Mechanical |
|
Manufacturing |
|
BOM |
|
Vendor part search |
|
BOM purchasing |
|
DeviceMart cart |
|
Staged editing |
|
Live IPC |
|
Status |
|
Resources: kicad://board (live IPC), kicad://schematic (live IPC),
kicad://schematic-file/{path*}, kicad://project/{path*}.
BOM item shape for purchasing
bom_purchase_list accepts a list of objects:
[
{"name": "Schottky diode", "mpn": "SB540-E3/54", "digikey_pn": "SB540-E3/54GICT-ND", "qty": 2},
{"name": "100nF", "mpn": "K104K15X7RF5TH5", "qty": 9},
{"name": "10k", "mpn": "CFR-25JB-52-10K", "qty": 10}
]mpn, digikey_product_number, digikey_pn, digikey_mpn, icmart_id and
devicemart_no are optional for bom_purchase_list; when absent the server
searches the selected site. Use exact MPNs or known product ids for
deterministic results. check_digikey_bom requires an exact MPN or DigiKey
product number for every non-module item; generic value-only items are
rejected so a fuzzy match is never reported as orderable.
Safety
KICAD_MCP_SAFE_MODE=1requiresconfirm=Trueon destructive tools.dry_runis available on PCB/schematic edit tools;pcb_batchrolls back on failure and checksexpected_revision.Cart writes always require
confirm=True; checkout/payment is not automated.Credentials and cookies live outside the repository.
Live IPC connection (optional)
get_kicad_version reports a live IPC connection when:
KiCad GUI is running
Preferences > Plugins > "Enable KiCad API server" is on
A PCB editor document is open
Without it, all file-based tools still work headless via kicad-cli.
The KiCad IPC API has no open-document command. ipc_open_board therefore
launches pcbnew.exe with the PCB path when no PCB editor is running, and waits
until the document appears in IPC. If pcbnew.exe is already running it does
not launch a second editor; open the board manually in that case.
Tests
uv run --with pytest pytest -q # 29 unit tests (core + vendor parsers + UTF-8 guard)
python tests/integration_test.py # 19 tool-level checks against a real KiCad demo project
python tests/stdio_test.py # MCP stdio handshake, tools/list (91), sample calls
python tests/smoke_live_parts.py # live read-only DigiKey/IC Mart/DeviceMart smoke testThe unit tests need no network and no KiCad install. integration_test.py copies
the KiCad pic_programmer demo project into a temp directory; override
KICAD_DEMO_DIR and KICAD_MCP_TEST_DIR if KiCad is installed elsewhere.
smoke_live_parts.py performs read-only searches and product lookups; DigiKey
requires the credential file above.
Known limits
Schematic editing is text-level (
.kicad_schS-expression editing); KiCad has no official schematic API. Re-run ERC after edits.get_board_infoparses.kicad_pcbdirectly (fast); for design-rule-precise data preferrun_drc.Live IPC tools require the KiCad GUI, the API server, and an open PCB document.
IC Mart and DeviceMart adapters parse server-rendered HTML/SSE; a site redesign can break them. DigiKey uses a stable JSON API.
DigiKey API quotas apply; requests are rate-limited and tokens cached.
Module parts are excluded from purchase BOMs by default and are not orderable through these tools.
No login, checkout or payment automation for any vendor.
Version history
Version | Change |
0.8.1 | Maintenance: UTF-8 enforcement, dead-code cleanup, standalone parts server removed |
0.8.0 | Vendor part search + BOM purchase lists + DeviceMart cart merged in (14 tools) |
0.7.0 | Version bump only (release marker for the DigiKey BOM workflow) |
0.6.0 | Fresh netlists, structured DRC/ERC, transactional PCB/schematic editing, library/mechanical/manufacturing/BOM tools |
0.5.2 | Deployable package, portable tests, opencode setup |
0.5.1 | IPC tool import fix, stdout JSON parse fix |
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Design, route, check, review and export manufacturable PCBs from plain language; KiCad import.
Run ERC, DRC, parity, BOM and export checks on KiCad 9 boards before manufacturing.
EasyGerber brings AI printed circuit board (PCB) design, layout, and routing to MCP-compatible assistants. Describe a circuit or start from firmware pin assignments, search published electronic components, and build schematics using catalog parts with their footprints and available 3D models. Create and revise boards, generate layouts with automatic component placement and routing, inspect previews, and check saved layouts for blocking design issues. Export manufacturing ZIPs containing Gerber and drill files, a bill of materials, and component placement data, or download an editable EasyGerber (.egb) file. Start without signing up. Your agent uses one private board reference to create and continue a board, including catalog access, edits, layout, checks, previews, and exports, without a separate guest setup step or token to manage. To keep the board in your account or work with permitted saved personal or organization boards, complete EasyGerber sign-in and OAuth consent, then resume the same task. Account permissions, plan limits, and generation billing apply; support depends on your MCP client and installed integration.
Design and revise PCBs from plain language, track jobs, and retrieve design artifacts.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to read and modify KiCAD PCB designs through the KiCAD IPC API, providing tools for board queries, footprint placement, track creation, DRC, and export.14MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to interact with KiCAD for PCB design automation, including schematic editing, component placement, routing, DRC/ERC, and export.10038 npm2MIT
- AlicenseBqualityDmaintenanceProvides schematic/PCB analysis, authoring, and SPICE simulation through MCP, enabling direct KiCad file manipulation and verification without requiring KiCad for reading.18MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to lint, render, fix, inspect, and find free space in KiCad schematics and PCBs, providing visual feedback and safe automated text fixes.10MIT