Skip to content

Releases: unmateria/MCP-Kicad

v0.2.4

Choose a tag to compare

@github-actions github-actions released this 10 Aug 20:50

Full Changelog: v0.2.3...v0.2.4

v0.2.3

Choose a tag to compare

@github-actions github-actions released this 10 Aug 19:12

Full Changelog: v0.2.2...v0.2.3

v0.2.2

Choose a tag to compare

@github-actions github-actions released this 09 Aug 21:08

Full Changelog: v0.2.1...v0.2.2

v0.2.1

Choose a tag to compare

@github-actions github-actions released this 09 Aug 19:21

Full Changelog: v0.2.0...v0.2.1

v0.1.2

Choose a tag to compare

@github-actions github-actions released this 08 Aug 21:58

Full Changelog: v0.1.1...v0.1.2

v0.1.1

Choose a tag to compare

@github-actions github-actions released this 08 Aug 21:49

Full Changelog: v0.1.0...v0.1.1

v0.1.0 — Schematics from a conversation

Choose a tag to compare

@unmateria unmateria released this 08 Aug 21:34

First public release. An MCP server that lets Claude design real KiCad schematics — placing parts, wiring nets, adding power symbols, and running KiCad's own ERC before handing you the file.

Install

  1. Download the binary for your system from the list below.
  2. On Linux/macOS: chmod +x mcp-kicad-*. On macOS also xattr -d com.apple.quarantine mcp-kicad-darwin-*, since the binary is unsigned.
  3. Add it to claude_desktop_config.json:
{
  "mcpServers": {
    "kicad": {
      "command": "C:\\Tools\\mcp-kicad-windows-amd64.exe",
      "args": []
    }
  }
}
  1. Quit Claude Desktop completely and reopen it — reloading the window is not enough.

Requires KiCad 10 installed; the server finds kicad-cli on its own. No configuration file needed.

Full instructions: README · en español

Which file do I need?

System File
Windows (Intel/AMD) mcp-kicad-windows-amd64.exe
Linux (Intel/AMD) mcp-kicad-linux-amd64
Linux (ARM, Raspberry Pi) mcp-kicad-linux-arm64
macOS (Apple Silicon) mcp-kicad-darwin-arm64
macOS (Intel) mcp-kicad-darwin-amd64

What it does

Describe a circuit in plain language and Claude compiles it into a .kicad_sch file you can open and edit. Every generated schematic is verified before you see it: no wire crosses a foreign net, no wire runs through a component body, every declared connection exists, no accidental ones do, and kicad-cli runs ERC on the result. Connections that cannot be drawn cleanly become net labels rather than wires that lie.

Schematics only — no PCB layout, routing or Gerbers in this release.

Only Windows is verified in practice. The Linux and macOS builds compile and carry platform-correct KiCad detection, but have not been run on real hardware — reports welcome.


En español

Primera versión pública. Servidor MCP que permite a Claude diseñar esquemas de KiCad de verdad: coloca componentes, cablea, añade símbolos de alimentación y pasa el ERC del propio KiCad antes de darte el fichero.

Instalación: descarga el binario de tu sistema (tabla de arriba), añádelo a claude_desktop_config.json como en el ejemplo, y cierra Claude Desktop del todo y vuelve a abrirlo. Necesita KiCad 10 instalado; encuentra kicad-cli solo. No hace falta fichero de configuración.

Qué hace: describes un circuito hablando y Claude lo compila a un .kicad_sch que puedes abrir y editar. Cada esquema se verifica antes de que lo veas: ningún cable cruza otra net, ninguno atraviesa un componente, todas las conexiones declaradas existen y no hay ninguna de más. Lo que no se puede cablear limpio pasa a etiqueta de net en vez de dibujar un cable que miente.

Solo esquemas — esta versión no hace PCB.

Solo Windows está verificado en la práctica. Las versiones de Linux y macOS compilan y detectan KiCad correctamente en cada plataforma, pero no se han probado sobre hardware real.