⚡ KiCad MCP

🔧 Automate PCB design • 🤖 AI-powered workflows • 🚀 Natural language commands

✨ What It Does

Control KiCad PCB design software through natural language via Claude Desktop:

Feature	Description
🎨 Project Creation	Initialize new KiCad projects with custom templates
🔍 DRC/ERC Checks	Run design rule and electrical rule checks automatically
📦 Component Management	Add, remove, and organize components programmatically
📤 Export & Manufacturing	Generate Gerber files, drill files, BOMs, and 3D models
🔄 Auto-Routing	Automatically route PCB traces with AI assistance
💰 Cost Estimation	Get production cost estimates from JLCPCB, PCBWay

🚀 Quick Setup

📋 Prerequisites

• Node.js >= 18.0.0
• KiCad 8.x installed on your system
• Claude Desktop app

📥 Installation

npm install -g @spark-apps/kicad-mcp

⚙️ Configure Claude Desktop

1. Open Claude Desktop settings and locate the MCP configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add KiCad MCP server to the configuration:

{
  "mcpServers": {
    "kicad-mcp": {
      "command": "npx",
      "args": ["-y", "@spark-apps/kicad-mcp"]
    }
  }
}

3. Restart Claude Desktop

4. Verify installation: Look for the 🔌 icon in Claude Desktop. Click it to see "kicad-mcp" listed as a connected server.

🛠️ Available Tools

	Tool	Description
	init	Create new KiCad projects with custom templates
	fix	Run design rule and electrical rule checks with auto-fix
	add/remove	Manage components programmatically
	export	Generate Gerber, drill files, PDFs, SVGs, STEP models
	bom	Generate Bill of Materials with supplier integration
	gen-3d	Create 3D models for visualization and verification
	route	Intelligent trace routing with AI assistance
	estimate	Production cost estimation (JLCPCB, PCBWay)

💬 Example Commands in Claude Desktop

<details> <summary><strong>🎨 Project Creation</strong></summary>

"Create a new 4-layer PCB project for ESP32 development"

"Initialize a simple Arduino shield project"

"List available project templates"

"Create a basic 2-layer PCB called 'my-sensor-board'"

Available Templates:

• basic - Simple 2-layer PCB
• esp32-dev - 4-layer ESP32 dev board with USB-C
• arduino-shield - 2-layer Arduino-compatible shield
• power-supply - 2-layer power supply board

</details>

<details> <summary><strong>🔍 Design Validation</strong></summary>

"Run DRC checks on my current board and fix all errors"

"Check for electrical rule violations in the schematic"

</details>

<details> <summary><strong>📤 Manufacturing Output</strong></summary>

"Export Gerber files for JLCPCB fabrication"

"Generate a complete BOM with supplier links"

"Create a 3D STEP model for mechanical verification"

</details>

<details> <summary><strong>🤖 AI-Powered Automation</strong></summary>

"Auto-route all remaining traces on the power supply section"

"Estimate production cost for 100 units via JLCPCB"

"Optimize component placement for thermal management"

</details>

🔧 Using with KiCad

Workflow Integration

1. Open your KiCad project in KiCad software
2. Open Claude Desktop alongside KiCad
3. Ask Claude to automate tasks using natural language
4. Review results in KiCad and iterate

Supported KiCad Versions

• KiCad 8.x (recommended)
• KiCad 7.x (limited support)

Important Notes

⚠️ Current Status: This MCP server uses a mock implementation for development. Real KiCad integration requires KiCad's IPC protocol implementation (coming soon).

✅ What Works Now:

• Project creation with templates and natural language prompts
• Template selection (basic, esp32-dev, arduino-shield, power-supply)
• Project metadata injection (author, description, tags, version)
• Command interface and workflow testing
• All tool signatures and parameter validation
• Integration with Claude Desktop
• Mock KiCad client for development/testing

🔄 Coming Soon:

• Real KiCad IPC integration
• Live project synchronization
• Advanced AI-powered routing
• Supplier API integration for BOMs

🐛 Troubleshooting

MCP Server Not Showing in Claude Desktop

1. Verify Node.js is installed: node --version
2. Check configuration file path is correct
3. Ensure JSON syntax is valid (use a JSON validator)
4. Restart Claude Desktop completely

Commands Not Working

1. Ensure KiCad is installed and accessible
2. Check project paths are correct
3. Verify file permissions for project directories

Need Help?

• 📖 Documentation
• 🐛 Report Bug
• 💬 Discussions

📝 License

MIT © Muammar Yacoob

🌟 Support

If you find this MCP server helpful:

• ⭐ Star the repository
• 💖 Sponsor the project
• 🐛 Report bugs and suggest features

---

Built with ❤️ for the KiCad and AI automation community