KiCAD Schematic Manipulation Server

MCP server for creating, editing, and inspecting KiCAD schematic files from AI tools and agents.

What it does

It wraps the kicad-sch-api library and exposes schematic actions over MCP, including:

• create, load, save, clone, and back up schematics
• add and remove components, wires, labels, text, and sheets
• search KiCAD symbol libraries
• inspect components, pins, and schematic metadata
• validate schematics and run bulk component updates

Install

pip install KiCAD-Schematic-Manipulation

Run

python -m mcp_kicad_sch_api

Or use the installed entrypoint:

KiCAD-Schematic-Manipulation

MCP client example

{
  "mcpServers": {
    "kicad-sch-api": {
      "command": "python",
      "args": ["-m", "mcp_kicad_sch_api"]
    }
  }
}

Main tools

• create_schematic
• load_schematic
• save_schematic
• add_component
• search_components
• add_wire
• add_label
• add_hierarchical_label
• add_junction
• add_sheet
• add_sheet_pin
• list_components
• list_component_pins
• get_component_pin_position
• get_schematic_info
• validate_schematic
• bulk_update_components

Requirements

• Python 3.10+
• KiCAD symbol libraries available on the machine
• kicad-sch-api

Development

git clone https://github.com/richard-luc/KiCAD-Schematic-Manipulation.git
cd KiCAD-Schematic-Manipulation
uv sync --dev
uv run python -m mcp_kicad_sch_api

License

MIT. See LICENSE.