# Hydroxyl

> Hydroxyl is an open-source MCP server for health and science. Local MCP server that draws, checks and converts chemical structures as journal figures. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://hydroxyl.app
- **Repository:** https://github.com/trebeljahr/hydroxyl.app/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.trebeljahr/hydroxyl
- **Categories:** health and science, design and media
- **Listing updated:** 2026-11-16

## About

hydroxyl-mcp runs on your own machine over stdio and makes no network calls, so structures only reach whichever assistant provider you use. It is the assistant-facing side of the Hydroxyl chemical structure editor, which produces publication figures sized for a journal column.

A structure can be given as SMILES, a molfile or a compound name from the editor's insert box, such as caffeine. From there the server can render a figure as PNG or SVG at single-column, double-column or a custom width in centimetres, and it warns when label text falls under 8 pt. It can also report valence and drawing issues with suggested one-click fixes, and give formula, molecular weight, exact mass, net charge and CIP labels.

The package needs Node.js 22 or newer and is MIT licensed. It depends on RDKit and resvg-wasm, and an environment variable can point the editor link at a local or self-hosted editor.

## Features

- **Journal figure rendering:** Draws a structure as PNG or SVG sized for a single or double column, or a width in cm.
- **Structure checks:** Flags valence and drawing issues, each with a one-click fix.
- **Property summary:** Reports formula, molecular weight, exact mass, net charge and CIP labels.
- **Format conversion:** Converts a structure to a molfile or canonical SMILES.
- **Editor links:** Returns a link that opens the structure in the Hydroxyl editor.
- **Runs offline:** Works locally over stdio with no network calls.

## Good for

- Generate a figure for a manuscript from a SMILES string
- Validate a hand-written structure before submitting
- Convert between SMILES and molfile
- Look up the formula and mass of a named compound

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `render_figure`: Renders a structure as a PNG or SVG figure at a chosen width and reports its printed size.
- `check_structure`: Lists valence and drawing issues with one-click fixes.
- `describe`: Returns formula, molecular weight, exact mass, net charge and CIP labels.
- `convert`: Converts a structure to a molfile or canonical SMILES.
- `editor_link`: Returns a link that opens the structure in the editor.

## FAQ

### Does it send my structures to a server?

No. The README says it runs locally, makes no network calls, and structures go only to your assistant's provider.

### What do I need to run it?

Node.js 22 or newer; clients start it with npx -y hydroxyl-mcp.

### What input formats work?

SMILES, molfile, or a compound name from the editor's insert box.

### Can I use my own editor instance?

Yes, set HYDROXYL_EDITOR_URL to a local or self-hosted editor.

### Is Hydroxyl free?

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

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

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

### What are the best alternatives to Hydroxyl?

The closest alternatives to Hydroxyl are HyperFrames by HeyGen, ffmpeg-skill, Tooluniverse, Oya Browser and AvatarSay — Fictional Character & Talking Video MCP.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.

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