healthCare
Local-first personal health management with evidence-linked records and scoped MCP tools.
All health data lives in an encrypted Vault (AES-GCM, passphrase-derived key) on the user's own machine. Agents never touch the Vault directly: they connect to an authenticated local IPC daemon over a unix socket with a paired-agent token that lives only in the macOS Keychain. Every mutation is audit-chained; deletions keep a snapshot behind an approval grant.
- MCP tools (28): vitals, medications, activities, emotions, sleep, encounters, diagnosis mentions, medication plans, reminders, trend summaries, timelines, visit-summary preparation, source evidence — all scoped per person and per agent.
- Zero network by default. An optional, user-configured LLM endpoint
(
HEALTHCARE_LLM_API_KEY/HEALTHCARE_LLM_ENDPOINT) exists for assisted report import; it is off unless explicitly configured. - Zero-config Hermes mode:
healthcare-hermesbootstraps Vault, daemon and agent pairing automatically underHEALTHCARE_HOME(the Hermes plugin data directory), then serves stdio MCP. - macOS only (agent pairing uses the macOS Keychain). Python ≥ 3.11.
Quick start (Hermes plugin)
Install the healthcare Hermes plugin — no manual setup needed. Or standalone:
uvx --from healthCare==0.2.0 healthcare-hermes
State layout under HEALTHCARE_HOME (default ~/.local/share/healthcare):
| Path | What |
|---|---|
family.vault |
encrypted Vault (AES-GCM) |
.vault-passphrase |
generated random passphrase, 0600 |
daemon.sock |
local IPC socket |
agent.json |
non-secret pairing profile (agent_id / host_id / person_id) |
The agent token never touches disk — macOS Keychain only.
CLI (operator use)
healthcare init / record-vital / record-medication / record-activity / record-sleep / record-emotion / record-encounter / record-diagnosis-mention / create-medication-plan / create-reminder / edit-record / delete-record / export / backup / restore / daemon / pair-agent / grant-consent / verify-audit … — see healthcare --help.
License
Apache-2.0. This repository is the public engine extract of a private monorepo;
src/ and tests/ are carried over unchanged.
1 maintainer
Release files for healthcare-mcp 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| healthcare_mcp-0.2.0.tar.gz | 163.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| healthcare_mcp-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 310.3 kB
Release files / healthcare_mcp-0.2.0.tar.gz
| Download URL | healthcare_mcp-0.2.0.tar.gz |
|---|---|
| Size | 163.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cd343b483ab135040ae0f656b16aec5bd9626667013d37869dac1c5d76220e19
|
|
BLAKE2b-256 checksum How to use checksums |
5fb446bb1ceba63bac79fbe39e42b2645d80355a7060bcef56c038a935c1864a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Release files / healthcare_mcp-0.2.0-py3-none-any.whl
| Download URL | healthcare_mcp-0.2.0-py3-none-any.whl |
|---|---|
| Size | 146.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
42c77376a58f60704ec01fb56acbbdd7496d8f1bf367a5d31a28986b1f0496d2
|
|
BLAKE2b-256 checksum How to use checksums |
64f285e11e6efeb2bfdb8a50b656175ac608725594754fc20871b9ceef62d554
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
