MedTracker

MedTracker is an open-source, self-hosted medication tracker for individuals, families, and carers. It supports household medication schedules, dose recording, stock tracking, reminders, and auditable history.

Important

MedTracker is currently in beta. It should supplement your existing medication routine. Do not depend on it for clinical decisions, emergency information, or your sole medication reminders, and do not use it as a replacement for established care.

Why MedTracker?

Medication management is rarely just a list of pills. When care is shared, families need to know what is due, what has already happened, whether supplies are running low, and who recorded each action. MedTracker brings that context together without handing control of it to a hosted service.

• See today's medication routine for everyone you care for in one place
• Replace uncertainty about a dose with a clear history
• Spot low stock before it becomes a last-minute problem
• Coordinate care for children, dependent adults, and other household members
• Keep an attributable record of who did what and when
• Run MedTracker on infrastructure you control

Try the self-hosted beta

We are looking for technically confident self-hosters to run MedTracker and try the journey from household setup to recording doses. Tell us where the app is confusing or unreliable.

For a private local evaluation:

git clone https://github.com/damacus/med-tracker.git
cd med-tracker
npm install -g portless
portless trust
task dev:portless
task dev:seed

Open https://med-tracker.localhost. Development seed data contains sample accounts with known passwords, so never expose a seeded development instance to a public or shared network.

Read the self-hosting guide before starting, and use the deployment guide for a production-style installation.

Share feedback

GitHub is the main home for MedTracker feedback:

• Start a Discussion for questions, early impressions, and self-hosting help
• Report a bug or request a feature using the short guided forms
• Report a security vulnerability privately

Please do not include names, medication details, health information, credentials, tokens, or unredacted logs in public issues or discussions.

Client Tools

First-party Rust tools live under client-tools/:

• medtracker: CLI for /api/v1 workflows.
• medtracker-mcp: stdio MCP server for agent clients.

Run local tool gates with task client-tools:fmt, task client-tools:check, task client-tools:clippy, and task client-tools:test.

Documentation

Published docs: https://damacus.github.io/med-tracker/

Key pages:

• Quick Start
• Glossary
• LLM Context Index (llms.txt)
• Kubernetes User Seeding
• Record a First Dose
• Testing
• Client Tools
• Design
• User Management

Build docs locally

task docs:serve

Contributing

See CONTRIBUTING.md for setup instructions, development workflow, and coding standards.