Skip to main content

Use BrickDb from Claude

When you're done

Claude on the web, in the desktop app or in Claude Code can search the catalogue, read and update your collection and look up prices, signed in with your BrickDb account.

About 5 minutes

Start

The steps

  1. Add BrickDb to Claude on the web or in the desktop app
  2. Add BrickDb to Claude Code
  3. Disconnect BrickDb

You need a free BrickDb account. The connection works only for registered members who sign in; nothing is available without signing in, not even the catalogue search. If you have no account yet, open your account page and create one on the sign-in page that opens. If you connect without signing in, Claude shows BrickDb as not connected or asks you to sign in, and none of BrickDb's tools can be used.

Claude works with your BrickDb account and your permissions, and nothing more: it sees what you see in BrickDb and can change only what you can change. What you ask it to look up in BrickDb becomes part of your conversation and is sent to Anthropic, the company behind Claude, which handles it under its own terms. BrickDb sends nothing to Anthropic on its own.

What it can do today:

  • search the catalogue and open a set;
  • show what a set sells for, with how many sales the figure rests on;
  • read your collection, add a copy, change its condition or notes, and remove a copy (removing asks for the set number as confirmation);
  • list the parts you own and work out what your collection is worth;
  • tell you what a scanned minifigure bag code is, and record what you found in a bag;
  • read your own MOCs and the public MOC gallery.

An administrator's account also reaches the tools of the admin area, because the account has that role. More of BrickDb, such as the wishlist, minifigures and photos, follows step by step.

Add BrickDb to Claude on the web or in the desktop app

Custom connectors are available on every Claude plan; the free plan allows one. On a Team or Enterprise plan, an owner adds BrickDb once under Organization settings → Connectors, and you then only choose Connect next to it.

  1. Open Customize → Connectors.
  2. Choose + Add, then Add custom connector.
  3. Enter the name BrickDb and the server URL https://mcp.brickdb.net/mcp, then choose Continue.
  4. Under Authentication, choose Sign in now.
  5. Under OAuth client, choose Use your own OAuth client, enter the client ID k6osd0WNm6FZExLto5McRIteb4StlPb4 and leave the client secret empty.
  6. Choose Add. BrickDb's sign-in page opens: sign in with your BrickDb account.

In a chat, choose + at the lower left, then Connectors, and switch BrickDb on for that conversation. Anthropic's help page: Getting started with custom connectors.

Add BrickDb to Claude Code

Run this in a terminal:

claude mcp add --transport http --scope user --client-id DJaeB6QbRJww7s3YiGd3iENDeSC4f9wA --callback-port 33418 brickdb https://mcp.brickdb.net/mcp

Then start Claude Code, type /mcp, choose brickdb and sign in with your BrickDb account in the browser that opens. The port 33418 has to be exactly this one: it is the only address BrickDb's sign-in returns to. There is no client secret. --scope user makes BrickDb available in all your projects. Anthropic's documentation: Connect Claude Code to tools via MCP.

Disconnect BrickDb

On the web or in the desktop app, open Customize → Connectors, choose the three dots next to BrickDb and remove it. In Claude Code, claude mcp remove brickdb removes BrickDb together with the sign-in Claude Code stored; Clear authentication in the /mcp menu signs you out and keeps the entry. Either way, Claude can no longer reach BrickDb with your account.

If the sign-in ends on an error page, or something else does not work, write to us through the support form.

Start Back to the guides

An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed. Trying again in seconds.

Failed to rejoin. Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session. Please reload the page.