chemdraw-mcp

Turns molecule names or SMILES into 2D structures, rotatable 3D models, reaction schemes, mechanisms and lab graphics (structures drawn locally with RDKit; PNG/SVG export), plus protein cartoons from the PDB or AlphaFold, with interactive panels in Claude Desktop. Unofficial, not affiliated with Revvity.

Documentation

chempane (chemdraw-mcp): An MCP server for chemistry, with interactive panels in Claude Desktop. Unofficial, not affiliated with Revvity.

chemdraw-mcp

CI Release License: Apache-2.0 PyPI GitHub stars

Ask Claude for a molecule. Get a drawing you can turn, click and export.

chemdraw-mcp gives Claude Desktop a chemistry panel. Type "Draw caffeine" and the structure appears in the chat: a clean skeletal formula, a 3D model you rotate with the mouse, the PubChem data sheet one tab away, PNG and SVG on disk. The same works for reaction mechanisms with electron-flow arrows, proteins and antibodies from the PDB or AlphaFold, spectra, TLC plates and titration curves.

The thalidomide panel: skeletal formula, All H, Show variants, the (S) isomer drawn with wedges, then the PubChem data sheet with the CAS number The thalidomide panel: the 3D button swaps the drawing for a ball-and-stick model in a bowl, rotated by dragging

Prompt: "Draw thalidomide". Left: skeletal formula, all hydrogens, the (S) isomer, the data sheet. Right: the same molecule in 3D, turned by dragging.

  • Interactive, not a picture. 13 of the 18 tools open a panel in the chat: switch views, pin a functional group, step through a mechanism, rotate a protein.
  • Drawn on your machine. RDKit draws every molecule locally. By default a SMILES you type stays there; only its InChIKey, a hash, is looked up.
  • Made for studying. A Study tab that covers name and groups, follow-up buttons that ask Claude about what you see, and Anki cards with the structure on the front.
  • Checked before it ships. About 10,000 tests, 67 inputs pinned to their InChIKey, and a scripted run in the real Claude Desktop before every release.
  • Free. No additional API key, no ChemDraw licence. Apache-2.0; unofficial, not affiliated with Revvity.

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):

uv tool install chemdraw-mcp && chemdraw-install

Names, data sheets and proteins are looked up online; drawing from a SMILES works offline. If chemdraw-mcp saves you an afternoon of drawing, a star on GitHub helps other students find it.

Quick start

  1. Install as above and restart Claude Desktop once.
  2. Open a new chat and ask "Draw caffeine".
  3. In the panel, click a functional group to pin it, switch to 3D for a rotatable model, Data for the PubChem data sheet or Study to quiz yourself, use Continue in chat for a follow-up, or Export PNG to copy the drawing as an image (where the clipboard is not available, it is saved to ~/ChemDraw-Output/png/).

Proteins and antibodies come as a cartoon from the PDB or AlphaFold, rotatable in the panel:

The lysozyme panel: hen egg-white lysozyme, PDB 1LYZ, as a cartoon with red helices, yellow strands and grey loops; after two seconds a drag turns it about the vertical axis

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.

Structure · Drawing structures

Draw beta-D-glucose

Panel for beta-D-glucose: the view bar switches from the skeletal formula to Fischer, Haworth and the chair conformation; formula C6H12O6 and molar mass 180.16 g/mol below

Mechanism · Reactions and mechanisms

Show the SN2 mechanism of
(R)-2-bromobutane with cyanide, step by step

Mechanism panel: Step by step through the SN2 reaction of (R)-2-bromobutane with cyanide, from the backside attack over the transition state to the inverted (S) product

Antibody · Peptides and proteins

Draw trastuzumab

Trastuzumab panel: the Fab fragment (PDB 1N8Z) as a cartoon, rotated and zoomed by dragging, then the Scheme tab with the IgG domain scheme, the shown Fab arm marked

Reaction · Reactions and mechanisms

Draw hydrogen + oxygen → water
as a reaction scheme

Reaction panel: hydrogen plus oxygen to water with the note 'not balanced', the suggestion 2 H2 + O2 → 2 H2O, and after Apply coefficients the scheme marked balanced

Lab graphic · Lab graphics

Titrate 25 mL of 0.1 M acetic acid with
0.1 M NaOH, indicator phenolphthalein
Titration curve of acetic acid with NaOH: equivalence point at 25 mL, pH = pKa = 4.76 at half equivalence, phenolphthalein band from pH 8.2 to 10

Anki · Anki decks

Make an Anki card for aspirin
in a deck called NSAIDs
The card from the generated deck: aspirin structure on the front, its name on the back

Installation

Pick one route for Claude Desktop. The extension and chemdraw-install register the same connectors, and installing both registers them twice. After installing, restart Claude Desktop once and ask "draw caffeine" in a new chat.

  1. 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.

  2. From PyPI (needs uv):

    uv tool install chemdraw-mcp && chemdraw-install
    
  3. From the repository (to read or change the code):

    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.

Other clients (need uv):

  • Claude Code: claude plugin marketplace add jurimaxam-dotcom/chemdraw-mcp, then claude plugin install chemdraw-mcp@chemdraw-mcp.
  • VS Code: Install in 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 complement each other: both can be on at once, and together they offer every tool, none of them twice.

ConnectorProfileToolsContents
chemdrawmvp (default)18, 13 with a panelthe five areas in the tool table
chemdraw-pharmapharma9, 4 with a panelsubstrate-scope figure, calibration curve, pharmacology curves, and calculators for solutions, content determination and pharmacokinetics (seven tools), plus the panel's two internal helpers

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. Turning a connector on or off in the connector menu needs no restart. Up to 0.10.0, chemdraw-pharma started with the full profile (every tool); if you used only that connector, enable chemdraw as well, or keep one connector with everything by setting CHEMDRAW_PROFILE=full in a config entry of your own. Re-run the installer to update an existing entry. Details: docs/configuration.md.

Tools

The default profile registers 18 tools, 13 of them with an interactive panel. Files go to ~/ChemDraw-Output/.

AreaToolExample prompt
Drawgenerate_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"
generate_mechanism"Show me the SN2 mechanism step by step"
generate_3d"Show methane as a rotatable 3D model"
generate_protein_or_antibody"Draw lysozyme", "Draw trastuzumab"
Lab graphicsgenerate_spectrum"Draw the IR spectrum of aspirin"
generate_tlc"TLC: educt Rf 0.3, product Rf 0.65, co-spot shows both"
generate_titration_curve"Titrate phosphoric acid with NaOH and show the curve"
generate_species_distribution"Species distribution of phosphoric acid over pH"
Look uplookup"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?"
Calculatecalculate_ph"What is the pH of 0.1 M acetic acid, pKa 4.76?"
Ankiexport_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

License and third-party data

Apache-2.0, see LICENSE. Copyright 2026 jurimaxam-dotcom.

The server builds on and asks:

  • RDKit (BSD-3-Clause) for parsing, layout, rendering and 3D conformers.
  • Mol* (MIT; Sehnal et al. 2021) for the protein cartoon in the panel; notices in THIRD_PARTY_LICENSES.
  • OPSIN, shipped inside py2opsin, for offline IUPAC names when Java is installed.
  • PubChem and NCI CIR for names, properties and GHS data; ChEBI and KEGG for lookup.
  • UniProt (CC BY 4.0) for protein entries.
  • 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