Fragrance & Perfume MCP (Noteboxd) — Claude Code MCP server
Links your assistant to the Noteboxd perfume database for fragrance notes, accord breakdowns, brand catalogs, and community reviews.
claude mcp add --transport http mcp https://mcp.noteboxd.com/mcpWhat Fragrance & Perfume MCP (Noteboxd) does
This server bridges your client to the Noteboxd API via standard input/output, returning structured JSON for every query. It equips the assistant with tools to filter fragrances by notes or price ranges, display side-by-side product comparisons, inspect perfumer credits, and read community review digests.
The package runs locally through npx and stores no user data. You must provide a valid NOTEBOXD_API_KEY, otherwise tool calls fail to authenticate. The free developer tier allows 50 requests per day without entering card details, with extra calls billed per request. An alternate remote HTTP endpoint is also provided if you avoid running Node locally.
What it helps with
- find alternative fragrances sharing similar accord structures
- compare notes and wear statistics between two perfumes
- summarize community sentiment and reviews for a specific scent
- look up perfume catalogs filtered by brand or perfumer
Example prompts for the agent
- Compare the notes of Bleu de Chanel and Dior Sauvage using Noteboxd data
- Find winter fragrances with heavy vanilla and cedar accords
- Summarize what reviewers say about Baccarat Rouge 540
How to install Fragrance & Perfume MCP (Noteboxd)
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.noteboxd.com/mcp2Platform CLI
claude mcp add --env NOTEBOXD_API_KEY=<NOTEBOXD_API_KEY> --transport stdio fragrance-perfume-mcp-noteboxd -- npx -y @noteboxd/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add fragrance-perfume-mcp-noteboxd --url https://mcp.noteboxd.com/mcp2Platform CLI
codex mcp add fragrance-perfume-mcp-noteboxd --env NOTEBOXD_API_KEY=<NOTEBOXD_API_KEY> -- npx -y @noteboxd/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"fragrance-perfume-mcp-noteboxd": {
"url": "https://mcp.noteboxd.com/mcp"
}
}
}{
"mcpServers": {
"fragrance-perfume-mcp-noteboxd": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<NOTEBOXD_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"fragrance-perfume-mcp-noteboxd": {
"type": "http",
"url": "https://mcp.noteboxd.com/mcp"
}
}
}{
"servers": {
"fragrance-perfume-mcp-noteboxd": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<NOTEBOXD_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http fragrance-perfume-mcp-noteboxd https://mcp.noteboxd.com/mcp2Platform CLI
gemini mcp add -e NOTEBOXD_API_KEY=<NOTEBOXD_API_KEY> fragrance-perfume-mcp-noteboxd npx -y @noteboxd/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Fragrance & Perfume MCP (Noteboxd)
How do I install Fragrance & Perfume MCP (Noteboxd) in Claude Code?
Run claude mcp add --env NOTEBOXD_API_KEY=<NOTEBOXD_API_KEY> --transport stdio fragrance-perfume-mcp-noteboxd -- npx -y @noteboxd/mcp for the local setup. To use the hosted endpoint instead, run claude mcp add --transport http fragrance-perfume-mcp-noteboxd https://mcp.noteboxd.com/mcp.
What data can the assistant access with this server?
It queries Noteboxd records covering fragrance accords, single-note profiles, brand directories, chart rankings, and community review digests.
Is a credit card required to start using the API?
No card is needed to register for the free tier, which covers 50 daily requests. Paid billing starts only if you exceed that threshold.
