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/mcpWhat 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
- Open Claude.ai → Settings → Connectors.
- Add a custom / remote MCP server and paste
https://itsmycloset.com/api/mcp. - Prefer OAuth when offered (Lookbook exposes protected-resource + authorization-server metadata and dynamic client registration). Sign in with Google on the consent screen.
- 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:
- Prefer OAuth:
npx -y mcp-remote https://itsmycloset.com/api/mcp
- Or pass a PAT via
--header/ a header file, e.g.Authorization: Bearer lb_…(create a token at /settings/mcp). - Point the Desktop config
command/argsat thatnpxinvocation (stdio), not at a remote URL block.
ChatGPT
- Enable Developer Mode / custom MCP connectors for your workspace.
- Register MCP server URL
https://itsmycloset.com/api/mcp. - Complete OAuth when prompted (Lookbook
/api/oauth/registersupports dynamic client registration). Approve access on https://itsmycloset.com.
Grok Bot
- Add a custom MCP connector at grok.com/connectors (Custom), or ask the bot to add the MCP server URL for you.
- MCP URL:
https://itsmycloset.com/api/mcp - Prefer OAuth when offered. Otherwise create a PAT at /settings/mcp and use it with the connector.
Muse (Meta)
- Once listed: open Muse → Settings → Connectors and enable Lookbook.
- Until listed: ask Muse for a Custom Connector pointed at
https://itsmycloset.com/api/mcp, using OAuth or a PAT from /settings/mcp. - 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.