chem-db-qmof

Query the QMOF database for DFT-computed MOF properties and CIF structures.

144|21|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill chem-db-qmof
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chem-db-qmof
Source: https://github.com/learningmatter-mit/AtomisticSkills/tree/main/.agents/skills/chem-db-qmof
Command: npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill chem-db-qmof

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mpcontribs-client, and includes scripts (resource) components.

What problem does it solve?

Finding and downloading DFT-relaxed structures for Metal-Organic Frameworks (MOFs) from the Quantum MOF (QMOF) database is slow and error-prone when done manually, especially when you need structures matching specific identifiers or properties like bandgap.

Core Features & Use Cases

  • Database querying for MOFs: Retrieve contributions hosted on Materials Project’s MPContribs (project qmof) by formula and/or identifier to narrow to the material subset you care about.
  • Relaxed structure downloads (CIF): Download the corresponding relaxed crystal structures as .cif files for downstream simulation, benchmarking, or model input preparation.
  • Reproducible runs: Saves skill input configuration for traceability after queries complete.

Quick Start

Use the query script to download up to 5 relaxed CIF files for Zinc-containing MOFs by running: python .agents/skills/chem-db-qmof/scripts/query_qmof.py --formula "Zn" --max-results 5 --output-dir ./research/qmof_results

Frequently Asked Questions about chem-db-qmof

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download DFT-relaxed MOF CIF structures from the QMOF database?

To download DFT-relaxed MOF CIF structures from the QMOF database, run the query_qmof.py script with specific formulas or identifiers to fetch and save the crystal structure files to your designated output directory.

Do I need an MP_API_KEY to query QMOF contributions on the Materials Project?

Yes, querying QMOF contributions on the Materials Project requires an MP_API_KEY environment variable to authenticate access via the mpcontribs-client dependency for retrieving DFT-computed properties and structures.

Can I retrieve MOF bandgaps and electronic properties by formula from the QMOF database?

You can retrieve MOF bandgaps and electronic properties by inputting specific chemical formulas into the query script, which filters QMOF database contributions to narrow down your dataset for atomistic materials workflows.

What is the best way to automate QMOF database queries for dataset building?

Automating QMOF database queries for dataset building is best achieved by running the query_qmof.py script, which programmatically fetches DFT-computed properties and downloads matching relaxed CIF structures.

Are there limits to the number of relaxed CIF files I can download from the QMOF database?

You can control the number of relaxed CIF files downloaded from the QMOF database by specifying the max-results argument in the query script, allowing targeted dataset building without retrieving the entire database.