📦

Seeed KiCad MCP Server

v3.5.0

Data IngestionLocalHardware

Based on Seeed-Studio/kicad-mcp-server. Best for validating existing projects, filling zones, async FreeRouting, and exporting Gerber/BOM/STEP/PDF/SVG plus JLCPCB packages. Requires KiCad-bundled Python (with pcbnew) and the package installed; upstream README also covers schematic/net analysis depending on version.

📖 Docs 🔗 Source

§ Quickstart

Add the following to your MCP client configuration (Cursor, Claude Desktop, etc.):

Launch with KiCad’s bundled interpreter so pcbnew imports reliably. Adjust the path for your KiCad version.

⚠️

On macOS/Linux, point command at the KiCad python binary. FreeRouting must be installed separately for auto_route.

Clone and install per README into the KiCad Python env, or set PYTHONPATH:

git clone https://github.com/Seeed-Studio/kicad-mcp-server.git

MCP Client Configuration

{
  "mcpServers": {
    "kicad-seeed": {
      "command": "C:\\Program Files\\KiCad\\10.0\\bin\\python.exe",
      "args": [
        "-m",
        "kicad_mcp_server"
      ],
      "env": {
        "PYTHONPATH": "C:\\Users\\YOUR_NAME\\Documents\\KiCad\\10.0\\3rdparty\\Python311\\site-packages"
      }
    }
  }
}

Config file locations

Common Windows path: C:\Program Files\KiCad\10.0\bin\python.exe

View full setup guide →

§ Tools Reference

10 tools

list_projects

List available KiCad projects

get_board_info

Get board size, layers, and component overview

Parameter	Type	Required	Description
project	string	✓	Project name

run_erc

Run ERC on the schematic

Parameter	Type	Required	Description
project	string	✓	Project name

run_drc

Run DRC on the PCB

Parameter	Type	Required	Description
project	string	✓	Project name

fill_zones

Fill all copper zones

Parameter	Type	Required	Description
project	string	✓	Project name

auto_route

Autoroute with FreeRouting (async, creates backup)

Parameter	Type	Required	Description
project	string	✓	Project name
max_passes	number	—	Max routing passes, default 100

export_gerber

Export Gerber and drill files

Parameter	Type	Required	Description
project	string	✓	Project name

export_bom

Export CSV BOM

Parameter	Type	Required	Description
project	string	✓	Project name

export_jlcpcb

Export JLCPCB / PCBWay manufacturing package

Parameter	Type	Required	Description
project	string	✓	Project name

export_all

Export all available manufacturing and preview files

Parameter	Type	Required	Description
project	string	✓	Project name

§ Examples

Once configured, you can ask the AI directly:

Validate a project

List projects, run ERC and DRC on my board, and summarize violations.

Quick pre-fab checks.

JLCPCB package

Run export_jlcpcb for the given project and list the generated files.

One-shot manufacturing handoff.