MCP server

PerfuMate Official

app.perfumate/perfumate

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Perfumery materials, IFRA Category 4, EU allergens, and your formulas and shelf via OAuth.

Website

At a glance

Type

MCP server

Publisher

perfumate.app (verified by the MCP Registry)

Status

Working at last check

Tools

45

Token cost

About 11,260 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http perfumate https://perfumate.app/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.perfumate]
url = "https://perfumate.app/mcp"

Gemini CLI

{"mcpServers":{"perfumate":{"httpUrl":"https://perfumate.app/mcp"}}}

Cursor

{"mcpServers":{"perfumate":{"url":"https://perfumate.app/mcp"}}}

VS Code

{"servers":{"perfumate":{"type":"http","url":"https://perfumate.app/mcp"}}}

Antigravity

agy mcp add perfumate https://perfumate.app/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"perfumate","server_url":"https://perfumate.app/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"perfumate","server_url":"https://perfumate.app/mcp"}

Tools

• add_to_shelf ~580 tokens
  Use this when the user says they have bought or own materials and wants them on their shelf. Adds catalog materials by name or CAS, or their own new ones; each item can carry the bottle strength, solvent, stock in grams, price per gram, supplier and lot. Without a strength, a catalog material gets i
• branch_version ~140 tokens
  Use this when the user wants to start a new line of work from a past version; the old working copy stays in the tree.
• check_formula ~527 tokens
  Use this when the user has a perfume or accord formula, pasted or drafted earlier in this conversation, and wants to know whether it is IFRA compliant, how much of the finished product it may be, which line to reduce, or which EU allergens the label must declare. Checks IFRA Category 4 (fine fragran
• confirm_delete Deletes data · ~151 tokens
  Use this only after the user has said yes to the list delete_items showed. Deletes exactly that list, with its token. If the list included a protected item, confirmName must be the formula's name as the user typed it. Items stay restorable for 30 days.
• create_formula ~812 tokens
  Use this when the user wants a new formula on their PerfuMate bench, empty or with lines they give (structured, pasted text or an attached file), for example after building one together in this chat. Lines are matched to the catalog and the user's own materials; if any line does not match, nothing i
• decompose_accord ~162 tokens
  Use this when the user wants an accord line replaced by the materials it holds, at the same dose, in place (undo_last_change takes it back).
• delete_items Deletes data · ~294 tokens
  Use this when the user asks to delete a formula, version, material, bottle, batch or note. It is step 1 of 2 and deletes NOTHING: it shows exactly what would be removed, with any protection, and returns a confirmation token valid for 10 minutes. Show the list to the user; only after they agree, call
• duplicate_formula ~147 tokens
  Use this when the user wants a copy of a formula to try changes on: an independent copy of its working copy with the same bottles, named "<name> copy" unless named.
• edit_formula ~853 tokens
  Use this when the user wants to change a formula on their bench: add or remove a material, set an amount or a bottle strength, swap a material, flag or note a line, reorder, or scale the whole formula. Changes the working copy in place, as one hand edit in the editor does. No version is made; undo_l
• find_starting_formula ~493 tokens
  Use this when the user wants to build, create, compose or formulate a perfume, fragrance or accord and needs a starting recipe (a rose, a citrus cologne, a clean musk, an amber), or asks what they could make with materials they list. Matches the idea to PerfuMate's reference accords, the vetted reci
• find_substitutes ~240 tokens
  Use this when the user lacks a material in a formula, or asks what they could use instead from the materials they own: the app's Find on shelf for one line, with single bottles and two- or three-bottle blends from the shelf that can play that material's part, best first, with a match percent and wha
• get_formula ~285 tokens
  Use this when the user wants to see one of their formulas: every line with material, bottle strength, amount, relative and absolute percent, flags and notes, plus totals, concentration, cost and the note pyramid. Optionally adds an IFRA Category 4 and EU allergen check of it ("is my formula IFRA com
• get_material ~252 tokens
  Use this when the user asks what one perfumery material smells like, how it is used, how strong or long-lasting it is, or how much of it IFRA allows (its Category 4 fine-fragrance limit, e.g. "how much Iso E Super can I use"). Returns the odour description, family, note, impact, blotter life, synony
• get_scent_profile ~218 tokens
  Use this when the user asks what a formula of theirs will smell like, how it evolves or how long it lasts, by PerfuMate's own scent model, exactly as the app's scent profile sheet shows it: families and sub-notes by weight and by perceived impact, the drydown at 0, 1, 4, 8 and 24 hours, the wear lin
• get_shelf_material ~127 tokens
  Use this when the user asks about one material they own: their notes, its bottles with recent stock movements, and the formulas that use it.
• insert_accord ~238 tokens
  Use this when the user wants to use one of their saved formulas as a single ingredient inside another, as the app's accords do: a virtual material carrying the flattened composition (so IFRA, allergens, cost and the scent profile see what is inside) on a bottle at the accord's own aromatic strength.
• journal_note ~126 tokens
  Use this when the user wants to add a dated line to a batch's maceration journal, or correct one.
• list_batches ~116 tokens
  Use this when the user asks about batches they have made, all or one formula's, with their maceration journal and days resting.
• list_deleted ~104 tokens
  Use this when the user wants to see what they deleted in the last 30 days and can still restore.
• list_formulas ~197 tokens
  Use this when the user asks what formulas they have, wants to find one by name, folder or favourite, or before you read or change a formula (it returns the ids the other tools use). Lists the formulas on the user's PerfuMate bench, pinned first then most recently edited, with folders. Locked formula
• list_notes ~96 tokens
  Use this when the user asks to read their PerfuMate notebooks: titles and previews, or one notebook in full by id.
• list_shelf ~142 tokens
  Use this when the user asks which materials they own, what is in stock or running low, or as the first step to suggest what they can make with their shelf. Lists the materials on the user's shelf, each with its bottles: strength, solvent, stock, price, supplier, lot and running low.
• list_shopping ~120 tokens
  Use this when the user asks what they need to buy: the Shopping cart's lists and their items (with list and category), and the materials running low. Optionally one list only.
• list_versions ~131 tokens
  Use this when the user asks about a formula's history: its version tree with notes and parents, which version is the working copy and which have batches.
• log_batch ~267 tokens
  Use this when the user has made a batch of a formula and wants it recorded: total weight, date, label and notes, optionally at a weaker strength, and optionally deducting what it used from stock. Works from the working copy or a version.
• make_dilution ~200 tokens
  Use this when the user has made, or wants to record, a dilution from a bottle they own; the material used is taken from the source bottle's stock.
• my_account ~118 tokens
  Use this when the user asks about their PerfuMate account or how big their bench is. Returns the linked account's plan ("unlimited" or "ai_studio") and its counts of formulas, shelf materials and notebooks; says so when the bench has not synced from the app yet.
• open_version ~145 tokens
  Use this when the user wants to go back and edit a past version directly, without cloning it. Refused for a version a batch was made from.
• rebuild_from_shelf ~212 tokens
  Use this when the user asks what they can make with the materials they own, or wants a formula rebuilt using only their shelf: the app's Replace with materials I own, showing how the formula can stand entirely on the shelf (what stays, what a stand-in replaces, what has to go). Without apply it only
• rename_folder Changes files · ~109 tokens
  Use this when the user wants to rename a formula folder: every formula filed in it moves (an empty name unfiles them).
• rename_version ~166 tokens
  Use this when the user wants to change a version's note or the number it carries.
• restore_deleted ~159 tokens
  Use this when the user wants something back from Recently deleted (deleted in the last 30 days).
• resync_accord ~175 tokens
  Use this when the source formula of an accord has changed and the user wants the accord line to follow: re-reads its composition, families and price as it is now, as the app's Re-sync does.
• save_version ~140 tokens
  Use this when the user wants to keep the current state of a formula as a named version in its evolution tree and carry on editing on a fresh copy.
• scale_to_concentration ~234 tokens
  Use this when the user wants to change a formula's concentration (for example from an eau de parfum to an eau de toilette) or its finished weight: the app's Scale sheet. The concentrate scales and the finishing alcohol makes up the rest, added from the catalog's perfumer's ethanol when there is none
• search_materials ~270 tokens
  Use this when the user wants to find perfumery materials by scent, family, name or CAS number, for example musks, woods or citrus to put in a formula, or the catalog name of a material they typed loosely. Returns up to 10 catalog materials (aroma chemicals, essential oils, absolutes, bases) with CAS
• set_preferences ~113 tokens
  Use this when the user wants to change the account's currency symbol or its default low-stock warning (grams; 0 turns it off).
• shopping_list ~261 tokens
  Use this when the user wants to add materials or free text to a Shopping cart list (the default list unless one is named; a new name makes that list), tick items as received or back to needed, or remove them.
• undo_last_change ~280 tokens
  Use this when the user wants to take back the last change made from the chat, to one formula or the last of any, from any chat. Pass the exact changeId from a write result or this tool's preview. Without changeId this only previews the latest change and changes nothing. Reuse the SAME changeId after
• update_bottle ~441 tokens
  Use this when the user wants to record stock for a bottle (a weighed count, or grams bought or used, through the stock ledger) or change its price per gram, supplier, lot, low-stock warning, strength, solvent or notes, take it on or off the shelf, or make it the preferred bottle.
• update_formula ~321 tokens
  Use this when the user wants to rename a formula or change its description, bench notes, kind (perfume or accord), folder, favourite star, pin, target concentration, IFRA category or bottle size.
• update_material ~546 tokens
  Use this when the user wants to change a material on their bench: their notes, odour description, families, note, impact, blotter hours, shelf life, synonyms, flash point or constituent breakdown; name and CAS only for their own materials.
• use_substitute ~243 tokens
  Use this when the user picks one of find_substitutes' suggestions: replaces the line with it (pass its member names), in place, with the app's own amounts, the same smell carried through each bottle's dilution, merged into a line that already holds that bottle.
• view_accord ~182 tokens
  Use this when the user asks what is inside an accord line of a formula: its materials at the dose it is used in, each with its share of the accord, read live from its source formula, and whether it can be decomposed.
• write_note ~127 tokens
  Use this when the user wants to create a notebook or change one: its title, body, appended text or pin.

Browse

• Food and recipes

Related MCP servers

• Glazecalc
  Ceramic glaze chemistry: unity formulas, limit checks, substitutes, cones and potters' guides.
• Scento Perfume API (MCP server)
  Free perfume & fragrance API and MCP server: notes, families, similar scents, 1,400+ perfumes.
• Parsley MCP by usefulapi
  Read Parsley menu items, nutrition, allergens, ingredients and events; record event sales and waste.
• Rootz Grocery
  Signed US food & grocery data: Kroger prices, nutrition, allergens, recalls, diet filters.
• Theaslangroupllc Pulsenetwork
  914 paid market-data & token-safety endpoints — keyless x402 USDC: Base, Solana, XRPL, +8 chains
• Materials
  Materials MCP — computed (DFT) materials structures & thermodynamic properties.
• Toolcall
  30 pay-per-call APIs for AI agents: compliance, trade, safety, web, data. USDC on Base via x402.
• Openfoodfacts
  Barcode lookup, nutrition search, and product comparison for 3M+ crowd-sourced food products.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/app.perfumate/perfumate.svg)](https://aptlynx.net/servers/app.perfumate/perfumate)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents