# KiCAD Schematic Manipulation

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

```bash
pip install KiCAD-Schematic-Manipulation
```

## Run

```bash
python -m mcp_kicad_sch_api
```

Or use the installed entrypoint:

```bash
KiCAD-Schematic-Manipulation
```

## MCP client example

```json
{
  "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

```bash
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](LICENSE).