US Medications

US Medications Skill

Look up US FDA medication information including uses, warnings, and drug interactions.

Data Source

• **FDA Drug Labels**: Official medication information from the US Food and Drug Administration
• **81,212 medications** in the full database
• **100 curated** common medications with instant access (no download needed)

Usage

Command Line

# Look up a medication (uses curated data, falls back to full database)
us-medications "lisinopril"

# Search for medications (partial match)
us-medications --search "blood pressure"

# Look up drug interactions
us-medications --interactions "warfarin"

# Show database statistics
us-medications --stats

# Download full database (happens automatically on first full lookup)
us-medications --download

# List common curated medications
us-medications --list

# Help
us-medications --help

JavaScript API

const {
  lookupMedication,
  searchMedications,
  lookupInteractions,
  downloadDatabase,
  getDatabaseStats,
  CURATED_MEDICATIONS,
} = require('us-medications');

// Look up a specific medication
const med = await lookupMedication('metformin');
console.log(med.uses, med.warnings);

// Search for medications
const results = await searchMedications('diabetes');
results.forEach((m) => console.log(m.name));

// Get drug interactions
const interactions = await lookupInteractions('lisinopril');

// Check if full database is available
const stats = await getDatabaseStats();
console.log(`${stats.totalMedications} medications available`);

Installation

npm (recommended)

npm install -g us-medications

The full database (~7.5MB compressed) downloads automatically on first use.

URL-based (OpenClaw)

https://birgermoell.github.io/us-medications/skill.md

Output Format

Each medication includes:

• **name**: Brand/generic name
• **altNames**: Alternative names
• **substances**: Active ingredients
• **form**: Dosage form (oral, injection, etc.)
• **rx**: Prescription required (true/false)
• **uses**: FDA-approved indications
• **warnings**: Safety information and contraindications
• **interactions**: Drug-drug interactions (when available)

Data Management

The full database is stored in ~/.us-medications/:

• medications.json - Main medication database
• interactions.json - Drug interaction data

To refresh data:

us-medications --download --force

Common Medication Categories

Cardiovascular

• Lisinopril, Metoprolol, Amlodipine, Losartan, Atorvastatin

Diabetes

• Metformin, Insulin (various), Glipizide, Januvia

Pain/Inflammation

• Ibuprofen, Acetaminophen, Naproxen, Tramadol

Mental Health

• Sertraline, Escitalopram, Alprazolam, Trazodone

Antibiotics

• Amoxicillin, Azithromycin, Ciprofloxacin, Doxycycline

Disclaimer

This tool provides FDA label information for educational purposes. **Always consult a healthcare professional** for medical advice. Do not use this tool for self-diagnosis or treatment decisions.