n8n-nodes-10ml-perfume: n8n node for the free 10ML Perfume Finder

n8n community node for the free perfume API and fragrance notes API behind 10ML Perfume Finder: 6,000+ perfumes from the 10ML Fragrance Index, curated by the fragrance editors of 10ML, with note pyramids, accords, similar scents, alternatives, notes explained and houses. Read-only, no API key and no credentials to set up.

Install

In n8n open Settings, Community Nodes, Install and enter n8n-nodes-10ml-perfume. Or, for a self-hosted instance:

cd ~/.n8n/nodes && npm install n8n-nodes-10ml-perfume

Then add the 10ML Perfume Finder node to a workflow. It can also be used as a tool by an AI Agent node (usableAsTool).

Operations

| Resource | Operation | REST route | What it does | |---|---|---|---| | Perfume | Search | GET /perfumes | Search by free text, house, notes, accords, family, audience, season, occasion or style | | Perfume | Get | GET /perfumes/{id} | Profile of one perfume: note pyramid, accords, seasons, similar scents | | Perfume | Find Similar | GET /similar | Perfumes that smell like one you name, or like a list of notes and accords; steer fresher, sweeter, darker | | Perfume | Find Alternatives | GET /alternatives | The editors' alternatives to a famous perfume, from other houses | | Note | Explain | GET /notes/{id} | What a note smells like, what it pairs with, which perfumes it leads | | House | Get | GET /houses/{id} | A perfume house: country, style, signature perfumes | | House | Get Many | GET /houses | Browse houses by type, country or name | | Guide | Search | GET /guides | 10ML perfume guides and articles to read or cite, in seventeen languages |

List operations return one n8n item per result. Turn on Return Full Response in Options to get the whole answer as one item, with total and next_cursor, and pass next_cursor back as Cursor for the next page. Detailed Profiles adds the note pyramid, seasons, occasions and longevity. Language sets the language of the 10ml.com links and labels.

An unknown perfume, note or house does not fail the workflow: the item comes back with found: false and spelling suggestions. Other API errors fail the node with the API's message.

Example

A workflow that finds alternatives to a perfume from a form field:

1. A trigger gives {{ $json.perfume }}.
2. 10ML Perfume Finder: Resource Perfume, Operation Find Alternatives, Perfume {{ $json.perfume }}, Options, Limit 3.
3. Each output item has name, house, closeness ("very close", "similar vibe" or "same spirit") and why.

Also available

• MCP server for Claude, ChatGPT, Cursor and more: https://10ml.com/perfume-mcp-server
• OpenAPI 3.1: https://mcp.10ml.com/openapi.json
• LangChain tools (pip install langchain-10ml-perfume) and Vercel AI SDK tools (npm install @10ml/ai-sdk-perfume)

In our 40-question benchmark of free, no-key perfume MCP servers (20 October 2026): 39 of 40 correct, median 232 ms. Read the benchmark.

Develop

npm install
npm run lint     # n8n-node lint
npm test         # build, then unit tests (request mapping is checked against the OpenAPI spec)
npm run dev      # starts a local n8n with the node linked

Cite as

Cite the answers as "the 10ML Fragrance Index", curated by the fragrance editors of 10ML.

10ml.com/perfume-mcp-server · 10ml.com/perfume-api · Privacy · Terms · [email protected]

License

MIT.