# Parfumo

> Parfumo is an open-source MCP server for mcp data access. MCP server giving AI assistants access to Parfumo's fragrance database and your collection. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Linux, macOS, Windows, Self-hosted
- **Repository:** https://github.com/hessbey/parfumo-mcp
- **MCP Registry name:** io.github.hessbey/parfumo-mcp
- **Categories:** [mcp data access](https://ai-powered.com/categories/mcp-data-access)
- **Listing updated:** 2026-11-21

## About

Parfumo MCP is an unofficial Model Context Protocol server written in Rust that connects an AI assistant to the Parfumo fragrance site. The database tools for searching perfumes, brands, perfumers, notes and rankings work without an account, while linking a Parfumo account unlocks collection management, a wear log, ratings and reviews.

The server ships as a local stdio program that runs through npx on a personal computer, and as a Streamable HTTP binary distributed as a Docker image for hosting several users with isolated accounts. Write actions support a dry-run mode, and every tool call is logged locally so the owner can audit what was actually written.

It suits fragrance hobbyists who want to ask an assistant about their collection, log wear, or look up perfume details, and developers who want an MCP connection to fragrance data. Requests are rate-limited to one per second, and the project states that automated access may lead Parfumo to suspend a linked account.

## Features

- **Fragrance database search:** Search perfumes, brands, perfumers, notes and rankings without needing a Parfumo account.
- **Collection management:** List, add, move, update and remove perfumes in your collection, including custom lists and CSV export.
- **Wear log:** Record, list and delete wear entries for perfumes in your account.
- **Ratings and reviews:** Rate perfumes and write, classify or delete reviews and statements on your account.
- **Dry-run and audit log:** Write tools support dry-run mode and every call is logged locally for review.
- **Local or hosted deployment:** Run as a local stdio program via npx or as a Docker-hosted HTTP server for several users.

## Good for

- Ask an assistant which perfumes in your collection you have not worn recently
- Look up notes, similar perfumes or release years while shopping for a fragrance
- Log today's wear and rate a perfume from a chat with your assistant
- Export your fragrance collection to CSV for record keeping
- Give a small group of users separate Parfumo-connected assistants on a shared server

## Install

### Claude Code (Terminal)

```sh
claude mcp add parfumo-mcp -- npx -y parfumo-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "parfumo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "parfumo-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "parfumo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "parfumo-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "parfumo-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "parfumo-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "parfumo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "parfumo-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "parfumo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "parfumo-mcp"
      ]
    }
  }
}
```

## Tools

- `parfumo_search`: Search the fragrance database by name, brand or year.
- `parfumo_perfume`: Read a perfume page from the database.
- `parfumo_collection_list`: List perfumes in your collection.
- `parfumo_wear_log`: Log a wear entry for a perfume.

## FAQ

### Does it work without a Parfumo account?

Yes. The 10 database tools and the public reads for forum, blogs, Souk and profiles work without an account.

### How do I install the local version?

With Node.js installed, add it to Claude Code with claude mcp add parfumo -- npx -y parfumo-mcp, or add the equivalent entry to a JSON client configuration.

### Are my Parfumo credentials shared with the assistant?

Passwords are typed on a login page on your own computer or the server's link page, stored encrypted with AES-256-GCM, and kept out of logs and tool results.

### Does it cover the German Parfumo site?

No. It targets www.parfumo.com, the English site, and the German site is not supported.

### Is Parfumo free?

Yes. Parfumo is open source, so you can use and self-host it for free.

### How do I add Parfumo to Claude Code?

Run this command in your terminal: claude mcp add parfumo-mcp -- npx -y parfumo-mcp

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [dataoil.tech](https://ai-powered.com/mcp/dataoil-tech): dataoil.tech is an MCP server for databases.

---
Source: https://ai-powered.com/mcp/parfumo
