Records vaccination history, tracks due dates for boosters, provides travel vaccination requirements, and maintains an immunization schedule. Use when the user logs vaccines, asks about upcoming vaccinations, or plans travel requiring immunizations.
Maintain a comprehensive record for each vaccination administered. Each entry includes the following fields:
| Field | Required | Description |
|---|---|---|
| vaccine_name | Yes | Name of the vaccine (e.g., Pfizer COVID-19, Shingrix) |
| date_administered | Yes | Date the vaccine was given (YYYY-MM-DD) |
| dose_number | Yes | Dose number in the series (e.g., 1 of 2, 2 of 3) |
| lot_number | No | Manufacturer lot number for the specific vial |
| provider | No | Name of clinic, pharmacy, or healthcare provider |
| site | Yes | Injection site (Left Arm, Right Arm, Left Thigh, Right Thigh, etc.) |
| next_due_date | Yes | Calculated date for the next dose or booster |
| notes |
| No |
| Any additional information (reactions, exemptions, etc.) |
When the user logs a vaccination, collect at minimum the required fields, calculate the next due date based on the standard schedule, and persist the record.
Reference schedule for recommending and tracking adult vaccinations:
| Vaccine | Primary Series | Booster Frequency |
|---|---|---|
| Influenza | Annual | Every year (fall) |
| COVID-19 | Primary + boosters | Per current guidelines |
| Tdap/Td | 1 Tdap then Td | Every 10 years |
| Shingles (Shingrix) | 2 doses (2-6 months apart) | Age 50+ |
| Pneumococcal | PCV20 or PCV15+PPSV23 | Age 65+ or risk factors |
| HPV | 2-3 doses | Through age 26 (catch-up to 45) |
| Hepatitis B | 3 doses (0, 1, 6 months) | If not previously vaccinated |
| Hepatitis A | 2 doses (0, 6 months) | If at risk |
| MMR | 1-2 doses | If born after 1957 without evidence of immunity |
| Varicella | 2 doses (4-8 weeks apart) | If no evidence of immunity |
Use the user's age, risk factors, and vaccination history to determine which vaccines are recommended, due, or overdue.
Track key childhood vaccines from birth through 18 years, following the CDC/WHO recommended timeline:
Support tracking for children by associating records with a named dependent.
Provide region-specific vaccination recommendations for international travel:
| Vaccine | Regions | Notes |
|---|---|---|
| Yellow Fever | Sub-Saharan Africa, tropical South America | International Certificate of Vaccination required for entry to many countries; administer at least 10 days before travel |
| Typhoid | South Asia, Africa, Central/South America | Oral (4 doses) or injectable (1 dose); recommended 2+ weeks before travel |
| Japanese Encephalitis | Rural areas of East/Southeast Asia, Pacific Islands | 2-dose series; complete 1+ week before travel |
| Rabies (pre-exposure) | South/Southeast Asia, Africa, Central/South America | 3-dose series over 21-28 days; recommended for prolonged stays or animal exposure risk |
| Meningococcal | Sub-Saharan Africa (meningitis belt), required for Hajj/Umrah | Administer at least 10 days before travel |
| Cholera | Areas with active outbreaks (parts of Africa, Asia) | Oral vaccine; 2 doses 1-6 weeks apart |
| Malaria prophylaxis | Sub-Saharan Africa, South/Southeast Asia, Central/South America | Not a vaccine but critical reminder; prescribe antimalarials based on region-specific resistance patterns; start before travel per drug schedule |
When the user specifies a travel destination:
Actively manage vaccination timing:
Calculate a percentage score reflecting how up-to-date the user is on recommended vaccinations:
Provide output in the following formats depending on context:
A formatted summary of all recorded vaccinations, displayed as a table:
| Vaccine | Date | Dose | Lot # | Provider | Site | Next Due |
|---|---|---|---|---|---|---|
| COVID-19 (Pfizer) | 2025-10-15 | Booster 3 | FN1234 | CVS Pharmacy | L Arm | 2026-10-15 |
| Tdap | 2023-03-01 | 1 | TD5678 | Dr. Smith | R Arm | 2033-03-01 |
A prioritized list of upcoming and overdue vaccinations:
OVERDUE:
- Influenza (2025-2026 season) — was due by Nov 2025
DUE SOON (next 90 days):
- Shingrix dose 2 — due by 2026-04-15
- Hepatitis A dose 2 — due by 2026-06-01
UPCOMING:
- Td booster — due 2033-03-01
A timeline for travel-related vaccinations:
Trip to Kenya — Departure: 2026-06-01
REQUIRED:
- [ ] Yellow Fever — administer by 2026-05-22 (10 days before departure)
RECOMMENDED:
- [ ] Typhoid (injectable) — administer by 2026-05-18 (2 weeks before)
- [ ] Hepatitis A dose 1 — administer ASAP (ideally 4+ weeks before)
- [ ] Malaria prophylaxis — obtain prescription, start per drug schedule
ALREADY COMPLETE:
- [x] Tdap — current (2023-03-01)
- [x] COVID-19 — current booster (2025-10-15)
All vaccination records are stored in items/vaccinations.md with the following structure:
# Vaccination Records
## Personal Information
- Name: [User Name]
- Date of Birth: [DOB]
- Known Allergies: [Any vaccine allergies]
- Risk Factors: [Immunocompromised, pregnancy, healthcare worker, etc.]
## Vaccination History
| Vaccine | Date | Dose | Lot # | Provider | Site | Next Due | Notes |
|---|---|---|---|---|---|---|---|
| [entries] |
## Dependents
### [Dependent Name] (DOB: [date])
| Vaccine | Date | Dose | Lot # | Provider | Site | Next Due | Notes |
|---|---|---|---|---|---|---|---|
| [entries] |
When updating records:
items/vaccinations.md file (create if it does not exist)IMPORTANT MEDICAL DISCLAIMER: This vaccination tracker is an organizational tool only. It does not constitute medical advice, diagnosis, or treatment.