manage_supplement
Add, update, stop, or delete medications and supplements in your wellness stack. Specify the item by name or ID; new entries default to today and stopped courses are recorded automatically.
Instructions
Add, update, end, or delete a medication or supplement. Use when the user describes their stack, adds a new item, changes a dose or schedule, says they stopped taking something, or wants to remove an entry.
INFER — do not ask:
action: 'add' for a new item, 'update' for changing a field, 'end' when they stopped/finished a course, 'delete' only to remove the record entirely
category: 'medication' for prescription/OTC drugs and pharmaceuticals, 'supplement' for vitamins/minerals/herbs/other dietary supplements — default 'supplement' if unclear
start_date: today for new entries
end_date (for 'end'): today unless the user specifies otherwise
ASK the user only if name is missing for a new entry, or 'end' (set end_date) vs 'delete' (remove record) intent is ambiguous.
SELECTOR for 'update', 'end', 'delete' — pass id if known, or supplement_name (case-insensitive substring, e.g. "magnesium") to resolve it. Exactly one of id or supplement_name required. If supplement_name matches more than one item, the call errors with candidate IDs to retry with.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ID. Required for update, end, delete unless supplement_name is given. | |
| form | No | Physical form: pill, capsule, tablet, softgel, powder, liquid, gummy, other. Optional. | |
| name | No | Name (e.g. 'Magnesium Glycinate' or 'Metformin'). Required for add; on update, sets a new name. | |
| brand | No | Brand name. Optional. | |
| notes | No | Free-text notes. Optional. | |
| action | Yes | What to do. Required. | |
| category | No | Category: 'medication' for drugs/pharmaceuticals, 'supplement' for vitamins/minerals/herbs. Default: 'supplement'. | |
| end_date | No | End date (YYYY-MM-DD). Set for 'end' action — default to today. Null means currently active. | |
| dose_unit | No | Unit for dose_amount: pills, capsules, tablets, softgels, g, mg, ml, IU, mcg, tbsp, scoop. Required for add. | |
| start_date | No | Start date (YYYY-MM-DD). Required for add — default to today. | |
| unit_label | No | Label for dose_per_unit (e.g. 'mg', 'IU'). Optional. | |
| dose_amount | No | Numeric dose quantity (e.g. 2 for '2 pills'). Required for add. | |
| period_unit | No | The period for times_per_period. Optional. | |
| time_of_day | No | When during the day: ['morning'], ['morning','evening'], ['night'], etc. Optional. | |
| dose_per_unit | No | Amount per individual unit (e.g. 240 for '240mg per pill'). Optional. | |
| frequency_type | No | Frequency category. Optional — default 'daily'. | |
| supplement_name | No | Alternative to id for update/end/delete: name substring, case-insensitive (e.g. "magnesium"). | |
| times_per_period | No | How many times per period (e.g. 2 for twice per week). Optional — default 1. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Human-readable result text returned by the tool. |