BoardRepo

Search and review KiCad and Altium PCB projects through a read-only OAuth MCP server.

View on boardrepo.comTry this MCPSponsored

Documentation

Connect your AI to BoardRepo

Your assistant reads the designs themselves: schematics, nets, BOMs, and source files. That covers every public board and the ones you store here, including private ones.

Let your agent set it upCopy prompt

Add the BoardRepo MCP server so you can search and read hardware boards for me.

It is a remote HTTP MCP server at https://boardrepo.com/mcp. It is read-only: search and read public KiCad and Altium boards, their BOMs, schematics, and 3D views. Auth is OAuth via dynamic client registration, so there is no API key or secret to set.

Run the right command for my MCP client, then start the OAuth sign-in and tell me once it is connected. For Claude Code that is: claude mcp add --scope user --transport http boardrepo https://boardrepo.com/mcp

If that command is not recognized, use my client's own way of adding a remote or HTTP MCP server with that URL.

Paste it into Claude Code, Cursor, Codex, Gemini CLI, or any coding agent, and it adds BoardRepo and signs you in for you.

Or paste this URL, no client ID or secret neededCopy URL

https://boardrepo.com/mcp

ClaudeWeb + desktop

Add BoardRepo to Claude (opens in a new tab)

Opens BoardRepo in Claude's connector directory. Press Connect, approve BoardRepo access, then ask Claude to search BoardRepo or to read a board's schematic and BOM. A connector belongs to your account rather than to one app, so it works in Claude on the web, in the desktop app, and on mobile without setting it up again.

Set it up by hand instead

  1. In Claude.ai or Claude Desktop, open Settings → Connectors → Add custom connector.
  2. Name it BoardRepo, paste https://boardrepo.com/mcp, and click Add.
  3. Click Connect, sign in to BoardRepo, review the access choice, and press Allow.

On a Team or Enterprise workspace, an Owner has to enable BoardRepo before members can connect it. Claude also limits free plans to one custom connector, which is the by-hand route above rather than the directory.

ChatGPTBetaWeb + desktop

  1. On a paid ChatGPT plan, open Settings → Connectors(or Apps & Connectors) → Advanced and turn on Developer mode.
  2. In Connectors, click Create, paste https://boardrepo.com/mcp as the MCP server URL, and set Authentication to OAuth.
  3. Create it, complete the BoardRepo sign-in, then turn the connector on in a chat to use it.

Developer mode is a beta feature on paid plans; on Business, Enterprise, and Edu an admin has to allow it. BoardRepo works as a chat connector. It will not show up as a Deep Research source, because it does not expose ChatGPT's search and fetch tools.

Claude CodeCLI

Run this once, then run /mcp and approve the browser sign-in:

claude mcp add --scope user --transport http boardrepo https://boardrepo.com/mcp

Drop --scope user to add it to the current project only.

OpenAI CodexCLI

Add the server, then start the OAuth login:

codex mcp add boardrepo --url https://boardrepo.com/mcp codex mcp login boardrepo

Remote MCP over OAuth is recent in Codex. If codex mcp add or codex mcp login is not recognized, update Codex (check codex --version).

CursorIDE

Add BoardRepo to Cursor

Cursor opens and asks you to sign in to BoardRepo. Approve it once and you are connected.

Set it up by hand instead

Add this to ~/.cursor/mcp.json, then click Loginwhen Cursor shows "Needs login":

{ "mcpServers": { "boardrepo": { "url": "https://boardrepo.com/mcp" } } }

VS Code (Copilot)IDE

Add BoardRepo to VS Code (opens in a new tab)

VS Code opens and asks you to Allow the sign-in. Then, in Chat, switch to Agent mode and turn on the BoardRepo tools.

Set it up by hand instead

  1. Command Palette → MCP: Add Server → HTTP, paste https://boardrepo.com/mcp, name it, and choose Global or Workspace.
  2. Start the server and Allow the sign-in. It writes: { "servers": { "boardrepo": { "type": "http", "url": "https://boardrepo.com/mcp" } } }

Needs GitHub Copilot. An organization policy can disable MCP.

Gemini CLICLI

Run this once, then approve the sign-in in your browser:

gemini mcp add --transport http boardrepo https://boardrepo.com/mcpSet it up by hand instead

Add this to ~/.gemini/settings.json. Use httpUrl, not url, or streaming HTTP will not work:

{ "mcpServers": { "boardrepo": { "httpUrl": "https://boardrepo.com/mcp", "authProviderType": "dynamic_discovery" } } }

Gemini appUS onlyWeb

  1. At gemini.google.com, open Settings & help → Connected Apps→ Add a custom app.
  2. Paste https://boardrepo.com/mcp, continue, and approve the sign-in.

Currently limited to personal Google accounts, ages 18+, in the US, with Activity on.

OpenCodeCLI

Add it to your OpenCode config: opencode.json in the project, or the global ~/.config/opencode/opencode.json. OpenCode runs the OAuth sign-in for a remote server itself, so there is no key to paste:

{ "$schema": "https://opencode.ai/config.json", "mcp": { "boardrepo": { "type": "remote", "url": "https://boardrepo.com/mcp", "enabled": true } } }

WindsurfIDE

Open Settings → Cascade → MCP Servers → Add custom server and paste https://boardrepo.com/mcp.

Set it up by hand instead

Edit ~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:

{ "mcpServers": { "boardrepo": { "serverUrl": "https://boardrepo.com/mcp" } } }

Windsurf should open the BoardRepo sign-in in your browser. If it does not, update Windsurf. Never type your BoardRepo password into an assistant.

LM StudioDesktop

Add BoardRepo to LM Studio

LM Studio opens and adds BoardRepo. The button needs 0.3.17 or newer; signing in from inside LM Studio needs 0.4.10 or newer.

Set it up by hand instead

Open the Program tab in the right sidebar, choose Install → Edit mcp.json, and add:

{ "mcpServers": { "boardrepo": { "url": "https://boardrepo.com/mcp" } } }

On an older build, or if LM Studio never asks you to sign in, use the fallback under "Any other MCP client" below, which runs the sign-in in your browser instead.

Any other MCP clientMCP

BoardRepo is a standard remote MCP server (Streamable HTTP) at https://boardrepo.com/mcp. Any MCP client that supports Streamable HTTP and OAuth dynamic client registration can connect with just this URL.

My client asks for a command to run, not a URL

Older clients cannot call a remote server directly. Run BoardRepo through the mcp-remote bridge instead: it sits on your machine, talks to us over the network, and opens the BoardRepo sign-in in your browser the first time you use it.

{ "mcpServers": { "boardrepo": { "command": "npx", "args": ["-y", "mcp-remote", "https://boardrepo.com/mcp"] } } }

Needs Node.js installed. The bridge is a third-party package, not published by BoardRepo.

Prefer to browse first? Head to the board library.

{"@context":"https://schema.org","@type":"Organization","name":"BoardRepo","url":"https://boardrepo.com","logo":"https://boardrepo.com/opengraph-image","description":"BoardRepo is the GitHub for hardware: share, view, and version electronics projects from KiCad and Altium, with more EDA tools on the way. Open the schematic, PCB, and BOM in the browser, no install."}