kicad-mcp-pro

Overview

KiCad MCP Pro is a comprehensive Model Context Protocol server that provides automation capabilities for KiCad PCB and schematic workflows. It exposes numerous tools for project setup, schematic editing, PCB inspection and editing, validation gates, DFM checks, SI/PI helpers, simulation support, and manufacturing exports. The server supports multiple profiles like 'minimal', 'pcb_only', 'schematic_only', 'manufacturing', 'analysis', and 'agent_full', making it adaptable to various workflow needs. It integrates with popular MCP clients like Claude Desktop, Claude Code, Cursor, VS Code, and Codex.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• kicad_set_project

  Set the current KiCad project path for all subsequent operations

  Try:Set the KiCad project to /home/user/my-pcb-projectTry:Switch to my new kicad project folder
• project_get_design_spec

  Retrieve design specifications from the current KiCad project

  Try:Get the design specifications for this PCB projectTry:Show me the current design requirements
• sch_build_circuit

  Build or modify circuits in the schematic editor

  Try:Build a voltage divider circuit with 10k and 22k resistorsTry:Add an op-amp to the schematic section
• pcb_sync_from_schematic

  Synchronize the PCB layout from the schematic

  Try:Update the PCB with all components from the schematicTry:Sync the board layout with latest schematic changes
• project_quality_gate_report

  Generate a quality report checking design standards and constraints

  Try:Run a quality check on my PCB designTry:Show me any design rule violations
• export_manufacturing_package

  Export manufacturing files for PCB production

  Try:Export all manufacturing files for my boardTry:Prepare production-ready package for the PCB
• export_gerber

  Export Gerber files for PCB manufacturing

  Try:Export Gerber files for the current boardTry:Generate all necessary Gerber layers
• export_bom

  Export bill of materials from the KiCad project

  Try:Generate a bill of materials for this projectTry:Export BOM in CSV format
• pcb_place_footprint

  Place footprints/components on the PCB layout

  Try:Place the microcontroller footprint at position X100 Y200Try:Add a resistor footprint to the PCB
• pcb_add_track

  Add copper tracks/traces to the PCB layout

  Try:Add a track between pin 1 and pin 2 of the connectorTry:Route a 10mil trace from U1 to R5
• pcb_add_via

  Add vias to connect different PCB layers

  Try:Add a via to connect top and bottom layersTry:Place via at position X50 Y75
• sch_add_symbol

  Add symbols to the schematic

  Try:Add a 74HC00 NAND gate symbol to the schematicTry:Place a capacitor symbol in the power section

Comparable tools

Installation

uvx kicad-mcp-pro --help
uvx kicad-mcp-pro health --json
uvx kicad-mcp-pro serve

pip install kicad-mcp-pro
kicad-mcp-pro --help
kicad-mcp-pro health --json
kicad-mcp-pro serve

{
  "servers": {
    "kicad": {
      "type": "stdio",
      "command": "uvx",
      "args": ["kicad-mcp-pro"],
      "env": {
        "KICAD_MCP_PROJECT_DIR": "/absolute/path/to/your/kicad-project",
        "KICAD_MCP_WORKSPACE_ROOT": "/absolute/path/to/your/workspace",
        "KICAD_MCP_PROFILE": "pcb_only"
      }
    }
  }
}

FAQ

What KiCad version is required?

KiCad MCP Pro requires KiCad 10 or later.

Does this work with MCP clients other than Claude?

Yes, it works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, VS Code, and Codex.

Compare kicad-mcp-pro with