Noteboxd MCP server
{
"mcpServers": {
"noteboxd": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp@latest"
],
"env": {
"NOTEBOXD_API_KEY": "<noteboxd_api_key>",
"NOTEBOXD_API_BASE_URL": "https://..."
}
}
}
}{
"mcpServers": {
"noteboxd": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp@latest"
],
"env": {
"NOTEBOXD_API_KEY": "<noteboxd_api_key>",
"NOTEBOXD_API_BASE_URL": "https://..."
}
}
}
}{
"mcpServers": {
"noteboxd": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp@latest"
],
"env": {
"NOTEBOXD_API_KEY": "<noteboxd_api_key>",
"NOTEBOXD_API_BASE_URL": "https://..."
}
}
}
}{
"servers": {
"noteboxd": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp@latest"
],
"env": {
"NOTEBOXD_API_KEY": "${input:noteboxd_api_key}",
"NOTEBOXD_API_BASE_URL": "${input:noteboxd_api_base_url}"
}
}
},
"inputs": [
{
"id": "noteboxd_api_key",
"type": "promptString",
"description": "Noteboxd api key",
"password": true
},
{
"id": "noteboxd_api_base_url",
"type": "promptString",
"description": "Noteboxd api base url",
"password": true
}
]
}{
"mcpServers": {
"noteboxd": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp@latest"
],
"env": {
"NOTEBOXD_API_KEY": "<noteboxd_api_key>",
"NOTEBOXD_API_BASE_URL": "https://..."
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @noteboxd/mcpversion 0.1.4
What it does
An MCP server for accessing Noteboxd's fragrance database. It lets you search fragrances, notes, accords, brands, perfumers, and community reviews through Claude, ChatGPT, Cursor, or other MCP clients.
- Search and compare fragrances to find recommendations based on notes, accords, or similar profiles.
- Look up fragrance details including community reviews, wearing statistics, and perfumer information.
- Browse fragrance charts, trending searches, and discover notes and accords by brand or perfumer.
Tools this server exposes
| Tool | Does |
|---|---|
| search | Search across fragrances, brands, notes, perfumers, and collections. |
| search_fragrances | Filter fragrances by query, brand, note, family, or price range. |
| trending | Retrieve trending searches and most-worn fragrances. |
| list_charts | List available chart rankings and leaderboards. |
| get_chart | Retrieve a specific chart's rankings. |
| get_fragrance | Fetch full fragrance profile including notes, accords, perfumer, and community score. |
| get_fragrance_reviews | Get paginated community reviews for a fragrance. |
| get_similar_fragrances | Find fragrances with a similar accord profile. |
| get_wearing_stats | Retrieve wearing counts for a fragrance over recent time windows. |
| compare_fragrances | Compare two fragrances side by side. |
| get_review_digest | Get a short summary of a fragrance's community reviews. |
| batch_get_fragrances | Fetch up to 50 fragrances by id in a single call. |
| enrich_fragrance | Retrieve a fragrance's profile plus notes, accords, reviews, and similar fragrances in one call. |
| get_brand | Fetch a brand's profile. |
| list_brand_fragrances | List fragrances from a specific brand. |
| get_perfumer | Get a perfumer's profile and their top creations. |
| list_notes | Browse available fragrance notes. |
| get_note | Retrieve profile for a single fragrance note. |
| list_accords | List accord families. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.