Personal Health Record Management - Symptom Tracking, Medication Reminders, and Medical History Storage

Honestly, I Used to Think Managing My Health Records Was a Hassle

Every time I went to the doctor and got asked, "When was your last headache?" or "What medication did you take, and what dosage?" I'd always stumble and fail to answer clearly. The messy handwriting on my medical records was often illegible, let alone systematically tracking trends in my blood pressure or blood sugar. That's until I discovered this tool called Medical, a personal health record manager, and finally found my way.

It's not an online medical platform, nor does it provide diagnoses (the official line says: "Not a doctor, not a diagnostic tool"). It's simply a local health data manager. All your data stays on your own computer, with privacy locked down tight—absolutely no third-party transmission. That gives me huge peace of mind, given how sensitive health data is.

Installation: Unbelievably Simple

If you're like me and use an environment that supports npx (like with Node.js installed), just run a single command in the terminal:

npx skills add https://github.com/xdelin/OpenClaw-Education-Skills --skill medical

After running it, the tool automatically creates a memory/health/ folder in your current project directory, pre-populated with several empty JSON files:

• medications.json — stores your medication list and dosing schedule
• symptoms.json — symptom timeline, e.g., when you had a headache and severity
• history.json — past medical history, surgical records, etc.
• vitals.json — vital signs like blood pressure, blood sugar, weight, etc.
• emergency.json — emergency health card data, used to generate a one-page summary

After that, everything is done via Python scripts in the scripts/ directory. At first I worried about remembering lots of commands, but only a few are commonly used—I'll list them later.

Core Features: Make You a "Health Record Pro" Instantly

The feature I use most often is symptom tracking. I used to visit a neurologist frequently for migraines, and the doctor always wanted to know the pattern of attacks. Now whenever I get a headache, I just run a script:

User: "I have headaches, 6/10 severity, worse in morning"
→ Use scripts/add_symptom.py

The system automatically logs severity, time, and context. Before the next follow‑up, I generate a symptom timeline—the doctor gets a clear picture, and the consultation is much more efficient.

Medication management is another essential. My dad has high blood pressure and used to forget to take his medicine. I set it up for him:

User: "I was prescribed Lisinopril 10mg daily"
→ Use scripts/add_medication.py
→ Store in memory/health/medications.json
→ Set up reminder schedule

Currently, the script only records, but reminders can be added with other scheduling tools—at least you'll never miss a dose again.

There's also vital signs recording. For example, after measuring your blood pressure each day:

User: "Blood pressure 130/85 this morning"
→ Use scripts/add_vital.py --type bp --value "130/85"
→ Track trends over time

After a few months, you'll see a trend chart and understand your own health status.

What surprised me most is the emergency health card feature. When traveling or in an emergency, just run:

User: "Give me my emergency health card"
→ Use scripts/generate_emergency_card.py
→ Output: One-page summary for wallet/phone lock screen

It compiles allergies, past medical history, emergency contacts, etc., on one sheet—perfect for keeping on your phone lock screen or in your wallet. It could save your life in a critical moment.

Safety: A Line That Never Crosses

This tool sets three strict red lines for security and privacy:

• ✅ Allowed: symptom tracking, medication reminders, appointment preparation, and other record‑keeping operations
• ❌ Absolutely NOT allowed: diagnosing diseases or interpreting symptoms
• ❌ Absolutely NOT allowed: recommending starting or stopping medications
• ❌ Absolutely NOT allowed: substituting professional medical advice

It also has an emergency protocol: if the user describes symptoms that may indicate an emergency (e.g., chest pain, difficulty breathing, heavy bleeding, loss of consciousness, suicidal thoughts), it immediately guides the person to call emergency services and stops logging. This design is incredibly thoughtful.

Script Family at a Glance

I've listed all the scripts below for your convenience:

• add_medication.py — Add a new medication, including dosing schedule
• list_medications.py — Display all current medications
• check_interactions.py — Check known drug interactions
• add_symptom.py — Record a symptom, including severity and context
• get_symptom_timeline.py — Generate a symptom history timeline (good for showing your doctor)
• add_vital.py — Record vital signs (blood pressure, blood sugar, weight, etc.)
• get_vital_... — (additional scripts for retrieving vital data, etc.)