LookbookImport

Install

Lookbook MCP

Connect Claude, ChatGPT, Grok Bot, or Muse to your Lookbook wardrobe over HTTPS. Auth is per-user (OAuth 2.1 + PKCE, or a personal access token) — not a shared server secret.

MCP URL

https://itsmycloset.com/api/mcp

What you can do

Once connected, an assistant can browse your wardrobe, create and edit looks, arrange flat-lay layouts, and manage collections — acting as you on the items and outfits in your account.

Claude.ai Connectors

  1. Open Claude.ai → Settings → Connectors.
  2. Add a custom / remote MCP server and paste https://itsmycloset.com/api/mcp.
  3. Prefer OAuth when offered (Lookbook exposes protected-resource + authorization-server metadata and dynamic client registration). Sign in with Google on the consent screen.
  4. Or use a PAT as Authorization: Bearer lb_… from Settings → MCP tokens.

Claude Desktop

Claude Desktop's claude_desktop_config.json only supports stdio servers — a bare url / headers remote entry is rejected as invalid. Bridge Lookbook with mcp-remote:

  1. Prefer OAuth:
    npx -y mcp-remote https://itsmycloset.com/api/mcp
  2. Or pass a PAT via --header / a header file, e.g. Authorization: Bearer lb_… (create a token at /settings/mcp).
  3. Point the Desktop config command / args at that npx invocation (stdio), not at a remote URL block.

ChatGPT

  1. Enable Developer Mode / custom MCP connectors for your workspace.
  2. Register MCP server URL https://itsmycloset.com/api/mcp.
  3. Complete OAuth when prompted (Lookbook /api/oauth/register supports dynamic client registration). Approve access on https://itsmycloset.com.

Grok Bot

  1. Add a custom MCP connector at grok.com/connectors (Custom), or ask the bot to add the MCP server URL for you.
  2. MCP URL: https://itsmycloset.com/api/mcp
  3. Prefer OAuth when offered. Otherwise create a PAT at /settings/mcp and use it with the connector.

Muse (Meta)

  1. Once listed: open Muse → Settings → Connectors and enable Lookbook.
  2. Until listed: ask Muse for a Custom Connector pointed at https://itsmycloset.com/api/mcp, using OAuth or a PAT from /settings/mcp.
  3. Builders submitting a directory connector can start at muse.ai/platform. Meta reviews submissions — Lookbook is not claiming to be in the Muse directory yet.

For Muse & Grok Bot

Builders: submit a Muse directory connector at muse.ai/platform, or add Lookbook as a custom connector at grok.com/connectors. See the Grok Bot / Muse sections above for end-user steps. Packaging notes for marketplace PRs live in the repo under docs/distribution/.

Personal access tokens

Signed-in users can create, list, and revoke tokens at /settings/mcp. Raw tokens are shown once and stored hashed (SHA-256). Prefix lb_. Prefer OAuth when the client supports it; use a PAT for clients that only accept a bearer header.

Security

Connections use your OAuth session or PAT and act as you — only share access with assistants you trust.

Operators (legacy)

Env LOOKBOOK_MCP_TOKEN still works for single-operator setups (scoped via LOOKBOOK_USER_EMAIL / LOOKBOOK_USER_ID). Prefer per-user PATs or OAuth for new installs.