KiCAD-MCP-Server
KiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Language Models (LLMs) like Claude to directly interact with KiCAD for printed circuit board design.
Install / Use
claude mcp add mixelpixx -- npx -y github:mixelpixx/KiCAD-MCP-ServerIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of KiCAD-MCP-Server
KiCAD-MCP-Server scores 86/100 on our quality scale, 522nd of 947 AI & Machine Learning skills we index.
Its MCP Server is 85 KB long, well organised into 192 sections with 52 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
With 3,387 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated today, so KiCAD-MCP-Server is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
ReviewOur scan of the whole file found 2 patterns worth reviewing before you install KiCAD-MCP-Server. An AI review of the same text found nothing harmful.
- mediumDisables the agent's permission promptsline 817
clients use to skip approval prompts. - mediumDisables the agent's permission promptsline 1368
Skip confirmation prompt when applying changes.
AI review by kimi-k2.7-code on 2026-11-14. Automated pattern scan on 2026-11-14. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
KiCAD-MCP-Server compared with similar skills
All 4 of these similar skills score higher than KiCAD-MCP-Server; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| KiCAD-MCP-Server (this skill)by mixelpixx | 86 | 3.4k | today | MCP Server |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
Frequently asked questions
- How do I install KiCAD-MCP-Server?
- Run
claude mcp add mixelpixx -- npx -y github:mixelpixx/KiCAD-MCP-Server. The install tabs above show the steps for each supported agent. - Which AI agents does KiCAD-MCP-Server work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is KiCAD-MCP-Server safe to use?
- Our scan of the whole file found 2 patterns worth reviewing before you install KiCAD-MCP-Server. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is KiCAD-MCP-Server still maintained?
- The repository was last updated today, so KiCAD-MCP-Server is actively maintained.
Skill content
View source on GitHubKiCAD MCP Server
A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with KiCAD for PCB design automation. Built on the MCP 2025-06-18 specification, this server provides comprehensive tool schemas and real-time project state access for intelligent PCB design workflows.
Open source (MIT) and actively maintained. New releases keep coming, and bug reports, pull requests and discussion are welcome here.
Konnect is now Konnect-EDA, at Orchis.ai
Konnect-EDA grew out of this project. It is a native KiCad 10 plugin: a single Rust binary that works through KiCad's official IPC API and
kicad-cli, with no SWIG. Its 228 tools, in 21 on-demand toolsets, cover schematic capture, PCB layout and routing, ERC and DRC, design-review audits, JLCPCB parts and fab outputs, with bundled skills for Claude and Codex.
- Free for students, hobbyists and individual developers, now and after 1.0. Everyone can use it free during the beta. From 1.0, personal, hobby, student and individual developer use stays free, with a free license key. Only businesses need a commercial license. See licensing.
- Get it: install guide and downloads on GitHub, and more at konnect-eda.orchis.ai.
- Runs on your machine. It sends nothing to Orchis.ai. See what leaves your machine.
- Help build it: report bugs and request features in its issues. Code contributors can sign up here.
The earlier
mixelpixx/Konnectrepository is archived. Konnect-EDA replaces it.
| | KiCAD MCP Server (this repository) | Konnect-EDA |
| -------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| License | MIT, open source | Closed source. Free for students, hobbyists and individual developers; businesses need a license from 1.0 |
| KiCad versions | 9 and 10 | 10 |
| Runs as | Python and TypeScript MCP server | Native KiCad plugin, a single Rust binary |
| Works through | KiCad's Python API (SWIG), with an experimental IPC backend | KiCad's IPC API and kicad-cli |
| Home | Here | Orchis-ai-LLC/Konnect-EDA · konnect-eda.orchis.ai |
Overview
The Model Context Protocol is an open standard from Anthropic that allows AI assistants to securely connect to external tools and data sources. This implementation provides a standardized bridge between AI assistants and KiCAD, enabling natural language control of PCB design operations.
Key Capabilities:
- 253 tools registered, every one of them indexed for keyword discovery
- 253 tools across 20 categories with JSON Schema validation
- Keyword tool discovery via
search_tools/get_category_tools - Optional toolboxes: start with a 37-tool core and open the rest by category, to save context and stay under client tool limits
- 23 dynamic resources exposing project state
- Complete schematic workflow with 65 tools (authoring, batch edits, hierarchy, layout) and dynamic symbol loading (~10,000 symbols)
- Freerouting autorouter integration (Java, Docker, or Podman)
- Custom footprint and symbol creation tools
- JLCPCB parts integration with 2.5M+ component catalog and local library search
- Datasheet enrichment via LCSC
- Full MCP 2025-06-18 protocol compliance
- Cross-platform support (Linux, Windows, macOS)
- Real-time KiCAD UI integration via IPC API (experimental)
- Comprehensive error handling and logging
Try out Arduino MCP - now you can get Claude to help in the IDE, real time!:
https://github.com/mixelpixx/arduino-ide
What's New in v2.9.0
Board inspection tools, operating modes, autorouting by layer and by net, and a large batch of fixes, most of them found on real boards. Thanks to @dp-web4, @karu2003, @rmskkn, @YORROY123, @0anes0, @vim4all, @AlexanderSaydakov, @TimChild, @zjywlive and @b0gdaniy.
New tools
get_stackupreads the stackup from the board file and can check it against a recipe;set_stackup_layersets one row's thickness and dielectric properties (@karu2003).summarize_viasandsummarize_net_coppercount a net's or a board's copper without listing thousands of items (@karu2003).audit_via_netscompares every via's net with a reference board or a git revision. KiCad can move a via onto another net when it saves, and DRC does not notice (@dp-web4).set_voltage_clearance_ruleswrites clearance and creepage rules graded by the working voltage between net classes, from a spacing table you supply (@dp-web4).get_component_listfilters by region (@karu2003). Two new prompts guide a DC power-distribution review and a shield review (@karu2003).
Operating modes
KICAD_MCP_OPERATING_MODE=readonlyleaves only the tools that cannot change the design, for review agents.manufacturingadds the export tools. Unset, nothing changes. The idea is from @b0gdaniy.
Autorouting
signalLayerskeeps tracks off plane layers, andlayerTraceCostsmakes a layer expensive rather than forbidden (@dp-web4).routeNetsandexcludeNetsroute one set of nets and keep the rest as they are, so a board can be routed one domain at a time (@dp-web4).- Every outline of a keepout rule area reaches Freerouting (@dp-web4).
Fixes
sync_schematic_to_boardtakes nets, symbol links and fields from KiCad's own netlist. On a real 333-pad board, 304 pads had the wrong net before (@dp-web4).- Saves are no longer refused as "changed externally" after
sync_schematic_to_board(@vim4all),autoroute,import_sesorrefill_zones. - Schematic edits are refused while the schematic is open in KiCad, which would otherwise overwrite them (@0anes0).
- Library listing and search find KiCad's tables under
KICAD_CONFIG_HOMEand on a fresh install. One behaviour change: the symbol loader now reads only the newest KiCad version's global table, as KiCad does (@dp-web4). add_viakeeps its net inside another net's zone and reads the parameters its schema declares;modify_traceworks on the IPC backend; STM32 symbols load again;search_footprintswithlibraryfinds late libraries (@dp-web4, @YORROY123, @rmskkn, @zjywlive).run_drcreports unconnected items and schematic parity, board tools keep working after an image render, and project libraries survive a move (@dp-web4, @AlexanderSaydakov).
Full details in the CHANGELOG.
What's New in v2.8.3
Toolboxes to keep the tool list small, a Linux setup script, and a batch of fixes. Thanks to @cornellana, @YORROY123, @reinauer and @ToThePointTechDev.
Toolboxes
- Set
KICAD_MCP_TOOLBOXES=coreand a client starts with 37 tools instead of about 250: the core tools,search_tools, andlist_toolboxes,open_toolboxandclose_toolbox. The assistant opens the toolboxes a task needs. Name toolboxes in the setting, such asschematic,drc, to have them open from the start; Claude Desktop needs that, because it doesn't re-read the tool list until it restarts. Without the setting nothing changes. See Toolboxes. - Every tool now has a category, so
search_toolsfinds all of them (#345).
Setup
setup-linux.shdetects KiCad's Python, checks the dependencies in the environment it will configure, and merges the server into Claude Desktop's config with a backup, likesetup-macos.sh(#445, @reinauer).
Fixes
export_gerberwrites the files it reports. On the SWIG backend it wrote none while listing every layer (#455, #456, @cornellana).download_jlcpcb_databasegets the time a download needs, reports the real error when it fails, and no longer mixes cached yaqwsx volumes from different days (#454).- A tool call made while the server is still starting waits instead of failing with "Python process ... is not running" (#453).
- Courtyard checks test each outline of a multi-outline courtyard separately (#406, #452, @YORROY123).
route_differential_pairreads the parameters its schema declares, andgapis the edge-to-edge spacing;get_nets_listreturns the statistics it advertises, andget_net_padshonoursunit(#450, #451, @YORROY123).- MCP SDK 1.31.0 (from 1.29.0).
Full details in the CHANGELOG.
What's New in v2.8.2
A patch release with three fixes. KiCad 10's stock libraries are found on installs where the global library table refers to them through a variable. New sheets are written the way KiCad writes them. A line break in a value no longer makes KiCad drop a sheet. Thanks to @zerthimon, who reported and fixed the first two and traced the third.
KiCad 10's stock libraries
- KiCad 10's global library tables hold one row that points to KiCad's own
table of stock libraries. Where that row uses
${KICAD10_TEMPLATE_DIR}, as on Linux, the server found none of them:search_symbolscame back empty andlist_library_symbolsfailed forDevice. The row is now followed, so all 223 symbol and 155 footprint libraries are found (#438, #439). - Loading a library table went from about half a second to a few milliseconds, because path variables are now resolved once per table instead of once per row.
Hierarchical sheets
add_hierarchical_sheetwrites a sheet the way KiCad does. It uses theSheetnameandSheetfileproperty names, and puts the page number inside the sheet block, once for each use of the parent sheet. KiCad 10 flagged the old format when the project was opened (#436, #437).- Page numbers are unique across the project, and adding a sheet inside a sub-sheet no longer fails.
Line breaks in values
- A multi-line value, such as a Description set with
edit_schematic_component, was written with a raw line break that KiCad cannot read. In a sub-sheet, KiCad then left the whole sheet out of the design without an error. On KiCad's complex_hierarchy demo, one such value took the netlist from 68 components to 10. Line breaks are now written the way KiCad writes them (#441). get_schematic_componentreturns fields whose values contain quotes, such as the Description of KiCad's stock GND symbol. Before, those fields were missing from its result.
Installing
- The install instructions now clone the
stablebranch, which holds the latest release.mainmay carry fixes that are not released yet.
Full details in the CHANGELOG.
What's New in v2.8.1
A patch release with three fixes for hierarchical schematics and KiCad 10-only machines. They came out of reviewing the fixes that went into v2.8.0.
Parts on reused sheets get a reference per use
- A sheet placed more than once gets an instance entry, with its own refer
Truncated for display — read the full file on GitHub.
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
