Skip to content
MCP server

Hydroxyl

Local MCP server that draws, checks and converts chemical structures as journal figures

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.1.0
Listing updated
1 day ago

About Hydroxyl

Hydroxyl is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add hydroxyl -- npx -y hydroxyl-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hydroxyl": {
      "command": "npx",
      "args": [
        "-y",
        "hydroxyl-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hydroxyl": {
      "command": "npx",
      "args": [
        "-y",
        "hydroxyl-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • HYDROXYL_EDITOR_URLEditor that editor_link points at (default https://hydroxyl.app/editor/)

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licensed

Prices change. Check hydroxyl.app before you buy.

Hydroxyl 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 to Hydroxyl

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  4. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  5. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media