# Altium Designer MCP

> Altium Designer MCP is an MCP server for engineering simulation. Let an AI assistant create and edit Altium footprint and symbol libraries. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, Windows, macOS, Linux
- **Repository:** https://github.com/embedded-society/altium-designer-mcp
- **MCP Registry name:** io.github.embedded-society/altium-designer-mcp
- **Categories:** [engineering simulation](https://ai-powered.com/categories/engineering-simulation), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

Altium's .PcbLib and .SchLib files use an undocumented binary format that language models cannot write without corrupting it. This server takes over the file handling so the assistant can concentrate on the engineering: reading a datasheet, applying IPC-7351B pad sizes, choosing courtyards and silkscreen, and deciding what primitives to place. The README says that split is the point, and that it works for any component, not a fixed set of package generators.

The README counts 34 tools across reading and writing libraries, listing and searching components, previewing footprints and symbols as ASCII art, extracting styling from an existing library, comparing libraries and components, editing pads and primitives in place, batch updates, reordering, managing schematic parameters and footprint links, and deleting, copying or renaming components. STEP model attachment is also handled by the server.

It is for people who already design in Altium and use an MCP client. Client setup guides cover Claude Code, Claude Desktop, Cursor, VS Code and many others on Windows, Linux and macOS. It runs over stdio and is also published as an mcpb bundle.

## Features

- **Read and write libraries:** Handles .PcbLib footprint and .SchLib symbol files safely.
- **Primitive placement:** Places pads, tracks, arcs, text, fills and regions chosen by the AI.
- **ASCII previews:** Renders footprints and symbols as text for quick checks.
- **Style extraction:** Copies the styling of an existing library for new parts.
- **Library comparison:** Diffs two libraries or two components.
- **In-place edits:** Updates pads and primitives or applies batch changes.
- **Component management:** Copies, renames, deletes and reorders components.

## Good for

- Generate a footprint for a new package from datasheet dimensions
- Create a matching schematic symbol and link it to the footprint
- Apply one style change across every component in a library
- Diff two versions of a footprint library
- Search a library for components by pattern

## Install

### Claude Code (Terminal)

```sh
claude mcp add altium-designer-mcp -- npx -y https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "altium-designer-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}
```

## Tools

- `read_pcblib`: Reads footprints from a .PcbLib.
- `write_pcblib`: Writes footprints to a .PcbLib.
- `read_schlib`: Reads symbols from a .SchLib.
- `write_schlib`: Writes symbols to a .SchLib.
- `list_components`: Lists component names, paginated.
- `get_component`: Returns one component's full data.
- `search_components`: Searches libraries by regex or glob.
- `component_exists`: Checks whether components exist.
- `render_footprint`: ASCII-art preview of a footprint.
- `render_symbol`: ASCII-art preview of a symbol.
- `extract_style`: Extracts styling from an existing library.
- `diff_libraries`: Compares two library files.
- `compare_components`: Diffs two components.
- `update_component`: Updates a component, keeping its position.
- `update_pad`: Updates one pad's properties.
- `update_primitive`: Updates one primitive.
- `batch_update`: Applies updates across all components.
- `reorder_components`: Reorders components in a library.
- `manage_schlib_parameters`: Lists, gets, sets or removes SchLib parameters.
- `manage_schlib_footprints`: Manages footprint links in SchLib symbols.
- `delete_component`: Deletes components.
- `copy_component`: Duplicates a component within a library.
- `rename_component`: Renames a component.

## FAQ

### What file types does it handle?

Altium Designer .PcbLib footprint and .SchLib symbol libraries.

### Who does the engineering?

The AI does IPC-7351B calculations and layout decisions; the server reads, writes and places primitives.

### How many tools are there?

The README says 34.

### Which clients are supported?

Any stdio MCP client, with guides for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed and more.

### Do I need Altium?

Yes, the README says it is not for people who do not use Altium.

### How do I add Altium Designer MCP to Claude Code?

Run this command in your terminal: claude mcp add altium-designer-mcp -- npx -y https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb

### What are the best alternatives to Altium Designer MCP?

The closest alternatives to Altium Designer MCP are Copper-KiCad, MCP, PCBBrew, Network Sketcher (Local MCP) and Autonomous 0-DRC PCB Routing Foundry & Hardware MCP Server.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Copper-KiCad](https://ai-powered.com/mcp/copper-kicad): Copper-KiCad is an open-source MCP server for developer tools.
- [MCP](https://ai-powered.com/mcp/mcp-mwep63z6): MCP is a freemium MCP server for engineering simulation.
- [PCBBrew](https://ai-powered.com/mcp/pcbbrew): PCBBrew is a free MCP server for engineering simulation.
- [Network Sketcher (Local MCP)](https://ai-powered.com/mcp/network-sketcher-local-mcp): Network Sketcher (Local MCP) is an open-source MCP server for design and media.
- [Autonomous 0-DRC PCB Routing Foundry & Hardware MCP Server](https://ai-powered.com/mcp/autonomous-0-drc-pcb-routing-foundry-and-hardware-mcp-server): Autonomous 0-DRC PCB Routing Foundry & Hardware MCP Server is an MCP server for developer tools.
- [EasyGerber: AI PCB design, layout, and routing](https://ai-powered.com/mcp/easygerber-ai-pcb-design-layout-and-routing): EasyGerber: AI PCB design, layout, and routing is a freemium MCP server for design and media.
- [Pilotmcp](https://ai-powered.com/mcp/pilotmcp-2): Pilotmcp is an open-source MCP server for developer tools.
- [Narshamcp](https://ai-powered.com/mcp/narshamcp): Narshamcp is a paid MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/altium-designer-mcp
