Claude Code

Zeo includes an MCP (Model Context Protocol) server that gives Claude Code direct access to the schematic and PCB editors. This lets you design hardware from the terminal with the same 46 tools available in Zeo's built-in agent sidebar.

Setup

1. Install Claude Code

Follow the official installation guide to install Claude Code.

2. Add the Zeo MCP Server

macOS:

claude mcp add zeo \
  -s user \
  -- /Applications/Zeo.app/Contents/Frameworks/Python.framework/Versions/Current/bin/python3 \
  -m kipy.mcp

Windows:

claude mcp add zeo -s user -- "C:\Program Files\Zeo\0.1\bin\zeo" mcp

Linux:

claude mcp add zeo \
  -s user \
  -- python3 -m kipy.mcp

Install kipy with pip if it's not bundled:

pip install kipy

This adds the server at user scope (-s user), so it's available in all projects.

3. Load the Instructions

At the start of each conversation, run the slash command:

/zeo:zeo-instructions

This loads Zeo-specific design guidelines into the conversation — tool workflows, placement conventions, wiring strategies, and ERC/DRC best practices. Without it, Claude Code has access to the tools but won't know the recommended workflows.

Usage

Make sure Zeo is running with a project open before using the tools. Claude Code will call check_status to verify the editor state.

> Design a voltage regulator circuit with an LM7805

> Place the footprints and route the PCB

> Run DRC and fix any errors

If Zeo isn't running, Claude Code can launch it:

> Launch Zeo and open my project at ~/Projects/my-board/my-board.kicad_pro

Available Tools

The MCP server exposes the same tools as the built-in agent. See the Tools reference for the full list.

Key categories:

  • General — check_status, launch_editor, screenshot
  • Schematic — sch_add, sch_place_companions, sch_connect_net, sch_run_erc, and more
  • PCB — pcb_place, pcb_add, pcb_autoroute, pcb_run_drc, pcb_export, and more
  • Components — jlc_search, mouser_get_part, digikey_get_part, datasheet_query, and more

Troubleshooting

MCP server fails to connect

Make sure Zeo is installed at the default location (/Applications/Zeo.app on macOS, C:\Program Files\Zeo\0.1 on Windows). If you installed it elsewhere, update the path in the claude mcp add command.

Tools return connection errors

The schematic and PCB editors must be open — tools communicate with the live editor via IPC. Use check_status to verify, then launch_editor to open them if needed.

Updating the MCP server

The MCP server is bundled with Zeo. When you update Zeo, the MCP server updates automatically — no need to reinstall.

Edit this page on GitHub