KiCAD MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NODE_ENV | No | Node environment, e.g. "production". | |
| LOG_LEVEL | No | Log verbosity (error/warn/info/debug, or off). KICAD_MCP_LOG_LEVEL wins if both are set. | info |
| PYTHONPATH | No | Python path so the server can import the pcbnew module. Platform-specific, e.g. Linux: /usr/lib/kicad/lib/python3/dist-packages, Windows: C:\Program Files\KiCad\10.0\lib\python3\dist-packages, macOS: /Applications/KiCad/KiCad.app/Contents/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages | |
| KICAD_PYTHON | No | User override for non-standard Python installations. If you see "Python executable not found: python3", manually specify the Python path here, e.g. /usr/bin/python3 | |
| KICAD_BACKEND | No | KiCAD backend preference: auto (try IPC first and fall back to SWIG), ipc (require KiCAD IPC), or swig (file-based pcbnew backend). | |
| KICAD_MCP_DEV | No | Set KICAD_MCP_DEV=1 to automatically save the MCP session log into the project's logs/ folder on every export_gerber and snapshot_project call. Useful for debugging and for attaching to GitHub issues. The session log contains your full tool call history, so review or delete logs/ before sharing a project directory publicly. | |
| JLCPCB_API_KEY | No | JLCPCB API appKey for the official JLCPCB API (requires enterprise account with order history). | |
| JLCPCB_API_SECRET | No | JLCPCB API appSecret for the official JLCPCB API (requires enterprise account with order history). | |
| KICAD_AUTO_LAUNCH | No | Whether KiCad is auto-launched, e.g. "false". | |
| KICAD_MCP_LOG_LEVEL | No | Log verbosity (error/warn/info/debug, or off). Overrides LOG_LEVEL. | |
| KICAD_MCP_DEBUG_SKIP | No | Set to 1 to re-enable the verbose kicad-skip parser DEBUG logs (muted by default). | |
| KICAD_GUI_DRIVER_ENABLE | No | Set KICAD_GUI_DRIVER_ENABLE=1 to make the GUI driver helper listen (on 127.0.0.1, with a per-session token). Nothing is installed until install_gui_driver is run. | |
| KICAD_MCP_LOG_MAX_BYTES | No | Max size per log file before it rotates; 0 disables rotation. | 10485760 |
| KICAD_MCP_LOG_BACKUP_COUNT | No | Number of rotated backups to keep. | 3 |
| KICAD_INTERACTIVE_SCHEMATIC | No | Set KICAD_INTERACTIVE_SCHEMATIC=1 to auto-confirm KiCad's reload dialog on Windows after schematic writes. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues