bguillow-rgb/perfume-picks-mcp

Query the Perfume Picks fragrance database from Claude, or any MCP-compatible AI client. Read-only access to 13,000+ fragrances with full note pyramids, accords, curated dupes, and community wear data.
Perfume Picks is the Fragrance DNA and collection journal for iOS — get it on the App Store.
Tools
| Tool | What it does |
|---|---|
| search_fragrances | Full-text catalog search with brand, family, gender, and MSRP filters |
| get_fragrance | Full record for one scent (by slug or name): note pyramid, accords, community scores |
| find_dupes | Curated cheaper smell-alikes with match percentage — "what smells like X without the price tag" |
| find_similar | Most-similar fragrances from a precomputed similarity ranking |
| get_recommendations | Picks from note/accord preferences + budget + occasion + gender |
| compare_fragrances | Side-by-side: notes, shared/distinct accords, scores, price delta |
| trending_fragrances | What Perfume Picks users are adding to their wardrobes right now |
| what_to_wear_tonight | A scent for right now — date-night picks use community compliment data, office picks use office-safety scores |
Every response includes source attribution, a citation-ready summary line, links, and data freshness dates. All scoring is deterministic — no AI calls happen inside the server. All tools are annotated read-only/idempotent.
Install (Claude Desktop)
Requires Node.js 18+.
Add to your claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config):
Restart Claude Desktop. No API key or configuration needed — the server ships with public read-only access.
Configuration (optional)
Environment variables override the defaults (explicit env vars only — this package never reads .env files):
| Variable | Purpose |
|---|---|
| SUPABASE_URL | Override the database URL |
| SUPABASE_SERVICE_ROLE_KEY | Internal use only — unlocks live 30-day wardrobe-add trending. Never distribute this key. |
Without the service key, trending_fragrances falls back to catalog popularity and labels the method in its response.
Remote endpoint (no install)
Streamable HTTP for web agents and MCP clients that take a URL:
Also listed on Smithery and the official MCP registry as io.github.bguillow-rgb/perfume-picks.
Example agent requests
Questions an agent can answer with these tools:
- *"What smells like Baccarat Rouge 540 without the price tag?"* → find_dupes (curated dupes with match %, e.g. Lattafa Ana Abiyedh Rouge, 90%)
- *"Recommend a fragrance for a summer wedding."* → get_recommendations with occasion: "wedding"
- *"What fragrances have bergamot, vanilla, and amber?"* → get_recommendations with those notes as preferences
- *"What perfume is similar to Bleu de Chanel?"* → find_similar
- *"What should I wear on a date tonight?"* → what_to_wear_tonight (scored by community compliment data)