Wardrowbe MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
wardrowbe-mcp
An MCP server for Wardrowbe, the self-hosted wardrobe app. It lets any MCP client list and inspect items, log wear and washes, suggest outfits, and check analytics.
Requires Node.js 20 or newer.
Quick start
You need your Wardrowbe URL and an OIDC client for Wardrowbe. Pocket ID works.
In your IdP, create a public client with PKCE. Allow the scopes
openid profile email offline_access, and add the redirect URIhttp://localhost:8765/callback.Add the server to your MCP client. For Claude Desktop or Claude Code:
{ "mcpServers": { "wardrowbe": { "command": "npx", "args": ["-y", "@mdeleon23/wardrowbe-mcp"], "env": { "WARDROWBE_URL": "https://wardrowbe.example.com", "OIDC_ISSUER_URL": "https://pocket.example.com", "OIDC_CLIENT_ID": "wardrowbe" } } } }Call
list_itemsfrom your client. The first time, your browser opens for sign-in. After that, the refresh token is saved and you won't be asked again.
To use a plain access token instead, set WARDROWBE_TOKEN in place of the OIDC_* variables. It expires, so OIDC is better for regular use.
Related MCP server: Pantry Buddy MCP
Configuration
Variable | Required | Default | Purpose |
| yes | Base URL of your Wardrowbe instance. | |
| or OIDC | A Wardrowbe access token (JWT). | |
| or token | OIDC issuer, e.g. | |
| with OIDC | OIDC client ID. | |
| no | Only for confidential clients. | |
| no | Use this refresh token instead of the saved one. For headless hosts (see below). | |
| no |
| Where the refresh token is saved. |
| no |
|
|
| no |
| Address for HTTP. Use |
| no |
| Port for HTTP. |
| http only | Bearer key that clients send to |
How sign-in works
With OIDC set, the server signs in through your browser the first time a tool needs a token. It catches the redirect on localhost:8765, then saves the refresh token to WARDROWBE_TOKEN_FILE with owner-only permissions. Later runs reuse it. If the token is revoked, the server signs in once more.
The browser sign-in needs a browser on the same machine as the server. On a headless host or in a container, sign in elsewhere and pass the token in:
npx -y @mdeleon23/wardrowbe-mcp login --issuer https://pocket.example.com --client-id wardrowbe > refresh-token.txtThen set OIDC_REFRESH_TOKEN to the contents of refresh-token.txt, and delete the file.
HTTP transport
For MCPHub or any client that connects to a URL:
MCP_TRANSPORT=http \
MCP_BIND_HOST=0.0.0.0 \
MCP_API_KEY="$(openssl rand -hex 32)" \
WARDROWBE_URL=https://wardrowbe.example.com \
OIDC_ISSUER_URL=https://pocket.example.com \
OIDC_CLIENT_ID=wardrowbe \
OIDC_REFRESH_TOKEN=<refresh-token> \
npx -y @mdeleon23/wardrowbe-mcpRegister the server at http://<host>:8080/mcp with the header Authorization: Bearer <MCP_API_KEY>. GET / returns a small info response without auth.
Adding items from photos
Photos go to the server directly, not through the AI, so the model never has to handle image bytes:
The app uploads the photo to
POST /uploadswith the same Bearer key. Send the raw image as the body, withContent-Typeset toimage/jpeg,image/png,image/webp, orimage/heic. Optionally setX-Filename(URL-encoded).The response is
{"upload_id": "...", "expires_in_seconds": 600}.The agent calls
add_itemwith thatupload_id. The upload is used once and then deleted. Uploads over 15 MB are refused, and uploads expire after 10 minutes.
curl -s -X POST https://<host>:8080/uploads \
-H "Authorization: Bearer <MCP_API_KEY>" \
-H "Content-Type: image/jpeg" \
-H "X-Filename: blue-shirt.jpg" \
--data-binary @blue-shirt.jpgAn agent can also do the whole thing through MCP with the upload_photo tool, which takes the photo as base64 (up to 300 KB) and returns an upload_id for add_item. The model has to write the image out in full, so keep photos small for this route. Full-size phone photos should go through /uploads.
add_item works over stdio too, as long as the upload_id came from upload_photo in the same server process. /uploads is HTTP only.
Tools
Tool | Wardrowbe endpoint | Notes |
|
| Filter by type, status, favorites, needs wash, search. Paginated. |
|
| |
|
| Defaults to today. |
|
| Defaults to today. |
|
| Rate limited to about 10 per minute per user. |
|
| |
|
| |
|
| Takes a small photo as base64 (up to 300 KB) and returns an |
|
| Takes an |
|
|
|
|
| Counts, insights, most and never worn items. Good first call. |
|
| Up to 5 items, from the same trend window. |
|
| Items worn since their last wash. |
|
| Hides an item from suggestions. Reversible. Takes an optional |
|
| Brings an archived item back. |
Skill
The server publishes skill://wardrowbe-skill/SKILL.md as an MCP resource. It explains which tool to use for each task, how to add an item from a photo (including re-encoding large photos), and how archiving works. Clients that install skills pick it up automatically. The source is in skill/SKILL.md.
Development
npm install
npm run build
npm testWritten against Wardrowbe 1.13.x. If Wardrowbe changes its endpoints, update src/tools.ts.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Authenticated MCP for a user's care circle: read CareEvents, list loved ones, inspect workspace.
Control Ration inventory, meals, meal plans, shopping lists, and credits from an MCP client.
Query, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables MCP-compatible clients like ChatGPT and Claude to manage a household's shared food inventory, meal plans, recipes, and preferences through natural language, with atomic updates and audit logging.-

Pantry Buddy MCPofficial
FlicenseNot gradedqualityCmaintenanceEnables managing a personal pantry, shopping lists, cookbook recipes, and saved receipts remotely through MCP tools using natural language or API calls.-- AlicenseNot gradedqualityBmaintenanceEnables conversational logging and retrieval of workouts, sets, weigh-ins, meals, goals, plans, and progress photos through MCP-capable AI clients, with authenticated per-user storage and export/query capabilities.ISC
- AlicenseBqualityBmaintenanceEnables MCP clients to read account status, plans, and recent workouts, search official exercise names, and, when writes are enabled, apply confirmed preview-first plan changes and historical workout logs.22MIT