Molecule names or SMILES to 2D structures, reactions, mechanisms, spectra - drawn locally by RDKit.
An MCP server that converts chemical inputs into 2D visual outputs. It accepts molecule names or SMILES strings and can render 2D structures, reactions, mechanisms, and spectra, performing these transformations offline via RDKit.
🛠️ Key Features
Converts molecule names or SMILES to 2D structures
Generates 2D reactions, mechanisms, and spectra
Works offline using RDKit
Exposes functionality via Model Context Protocol (MCP)
🚀 Use Cases
Visualizing molecules from names or SMILES
Producing reaction or mechanism diagrams for study contexts
Creating spectra-related 2D outputs from chemical “lab result” descriptions
⚡ Developer Benefits
Integrates with Claude Desktop through MCP
Supports cheminformatics workflows focused on structures, spectra, and reactions
Topics include RDKit, SMILES, and molecule visualization for learning and tutoring
⚠️ Limitations
The provided description only specifies offline RDKit-based rendering; no additional capabilities are stated.
Draw chemical structures in Claude Desktop, explore them in the chat, and export PNG or SVG.
An MCP server for chemistry, with interactive panels in Claude Desktop.
Install in Claude Desktop (macOS, Linux): download
chemdraw-mcp-<version>.mcpb from the
latest release,
double-click it, confirm, and restart Claude Desktop once.
Or with uv (uv must be installed):
bash
uv tool install chemdraw-mcp && chemdraw-install
No additional API key or ChemDraw licence. Structures are drawn locally with
RDKit; names, data sheets and proteins are looked up online. Free and open
source (Apache-2.0); unofficial, not affiliated with Revvity.
Quick start
Install as above and restart Claude Desktop once.
Open a new chat and ask "Draw caffeine".
In the panel, hover a functional group, click 3D for a rotatable
model, Data for the PubChem data sheet, or Export PNG to save the
drawing to ~/ChemDraw-Output/png/.
Proteins and antibodies come as a cartoon from the PDB or AlphaFold,
rotatable in the panel:
Prompt: "Draw lysozyme". Drag to rotate; colouring, Cartoon/Trace and Reset sit above the picture.
Gallery
Each picture is real output of the tool the prompt goes to (a panel screenshot
or the written file), not a drawing made for this page. More examples are on
the linked pages.
Make an Anki card for aspirin
in a deck called NSAIDs
Installation
Pick one route for Claude Desktop. The extension and chemdraw-install
register the same connectors, and installing both makes the model see every
tool twice. After installing, restart Claude Desktop once and ask
"draw caffeine" in a new chat.
Claude Desktop extension (macOS, Linux): download
chemdraw-mcp-<version>.mcpb from the
latest release,
double-click it and confirm in Claude Desktop. The first start downloads
the dependencies from PyPI, each file checked against hashes pinned at
release time; later starts are offline.
git clone https://github.com/jurimaxam-dotcom/chemdraw-mcp.git && cd chemdraw-mcp && ./install.sh
Something not working? uvx --from chemdraw-mcp chemdraw-doctor checks the
installation and prints the fix for each problem. Step-by-step instructions
and the config by hand:
docs/getting-started.md
and docs/installation.md.
Claude Code:claude plugin marketplace add jurimaxam-dotcom/chemdraw-mcp,
then claude plugin install chemdraw-mcp@chemdraw-mcp.
VS Code:
Cursor: add {"command":"uvx","args":["chemdraw-mcp"]} as server
chemdraw-mcp in mcp.json, or open
cursor://anysphere.cursor-deeplink/mcp/install?name=chemdraw-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJjaGVtZHJhdy1tY3AiXX0=
in the browser.
Codex:codex mcp add chemdraw -- uvx chemdraw-mcp
The interactive panel appears in clients that render MCP Apps, such as Claude
Desktop.
Profiles
Either Claude Desktop route registers two connectors from one
installation. They differ only in the profile the server starts with:
substrate-scope figure, calibration curve, pharmacology curves, and calculators for solutions, content determination and pharmacokinetics
The extension route ships them as two bundles (chemdraw-mcp-<version>.mcpb,
chemdraw-mcp-pharma-<version>.mcpb); chemdraw-install writes both entries
into claude_desktop_config.json. In a chat, enable one connector at a
time in the connector menu: with both on, the model sees the default tools
twice. Switching between them needs no restart. Details:
docs/configuration.md.
Tools
The default profile registers 18 tools, 13 of them with an interactive panel.
Files go to ~/ChemDraw-Output/.
Area
Tool
Example prompt
Draw
generate_molecule
"Draw caffeine"
batch_generate
"Draw adrenaline, noradrenaline and dopamine, each as its own file"
compare_molecules
"What is the difference between morphine and codeine?"
generate_reaction
"Draw the esterification of acetic acid with ethanol"
"Titrate phosphoric acid with NaOH and show the curve"
generate_species_distribution
"Species distribution of phosphoric acid over pH"
Look up
lookup
"What is the CAS number of paracetamol?"
lookup_molecule_data
"Give me a data sheet for capsaicin"
predict_spectrum
"Which IR bands should capsaicin show?"
Calculate
calculate_ph
"What is the pH of 0.1 M acetic acid, pKa 4.76?"
Anki
export_anki_deck
"Make Anki cards with the structures of aspirin, ibuprofen and paracetamol"
The other two tools belong to the panel and are never called by the model on
its own: save_png is the server half of the export button, and
load_panel_part fetches the images of a large result (a big molecule, a long
batch) piece by piece, so that the result stays small enough for Claude Desktop
to display.
Every tool in detail, with its options and limits:
docs/tools.md.
What leaves your machine
Structures are drawn locally. A SMILES or InChI you type is not sent to any
database by default; to fetch its name, CAS number and properties, the server
sends PubChem only the structure's InChIKey, a hash computed on your machine.
The key does not contain the structure; it only matches a record PubChem
already holds. If PubChem has no record for it, those fields stay empty.
Common group abbreviations (Ph, Boc, OMe …) are expanded locally; a
SMILES that still cannot be read is refused, not searched as a name.
Compound names you type are sent to PubChem, NCI and, for enzyme and protein
names, UniProt to resolve them; protein names and gene symbols go to UniProt,
the UniProt accession to PDBe and the AlphaFold DB, the PDB ID to RCSB. A
systematic IUPAC name reveals the structure as much as a SMILES does. To also
search by the SMILES itself, turn on Look up typed structures by SMILES in
the extension settings of Claude Desktop, or set CHEMDRAW_SMILES_LOOKUP=1.
This holds from version 0.10.0. Version 0.9.1 and earlier posted a typed
SMILES to PubChem when PubChem did not know its InChIKey, and lookup passed a
typed SMILES or InChI to PubChem, ChEBI, UniProt or KEGG. Details:
docs/privacy.md.
Limits
Lab graphics draw the numbers they are given. For a named compound Claude supplies literature values from memory; check them.
Curved-arrow mechanisms exist for SN1, SN2 and Fischer esterification only; other reactions get the net scheme.
Proteins: cartoon without side chains, up to 3000 residues; bound groups such as heme or an inhibitor are shown, water and buffer are not. Peptides from a sequence take up to 20 residues.
Names, data sheets and proteins need the internet; without Java, systematic IUPAC names do too.
Claude Desktop often answers knowledge questions from memory; add "use ChemDraw" to the prompt. The extension targets macOS and Linux; Windows is untested.
Documentation
Getting started: install, first prompt, the panel, where files land, troubleshooting
PDB structures (CC0), fetched through PDBe and the RCSB ModelServer, cited with their PDB ID.
AlphaFold DB models (CC BY 4.0; Jumper et al. 2021, Varadi et al. 2024).
Each protein image carries the source line of its structure.
Disclaimer: This is an unofficial, independent project, not affiliated
with or endorsed by Revvity. ChemDraw is a trademark of Revvity Signals
Software, Inc. This tool does not include or require ChemDraw; it can
optionally export files in the open CDXML format.
Contributing
Something broke?Open a bug report.
The form asks for the output of chemdraw-doctor.
Wrong chemistry? Use the bug form and name the compound and the figure.