Hydroxyl
Local MCP server that draws, checks and converts chemical structures as journal figures
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"hydroxyl": {
"command": "npx",
"args": [
"-y",
"hydroxyl-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"hydroxyl": {
"command": "npx",
"args": [
"-y",
"hydroxyl-mcp"
]
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Tooluniverse
MCP serverMCP server giving AI agents access to thousands of scientific research tools
Runs locally- Open source
- 1.8K GitHub stars
- Health and science

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media