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.1
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.1.tar.gz | 163.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| healthcare_mcp-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 310.3 kB
Release files / healthcare_mcp-0.2.1.tar.gz
| Download URL | healthcare_mcp-0.2.1.tar.gz |
|---|---|
| Size | 163.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
42c0340b5f5c1ed1d9c58f09f844f63c0b2b76b183ce83476d6cc6389dd40352
|
|
BLAKE2b-256 checksum How to use checksums |
64349f916296551ff4546cd6614e94167de73abc3efa0de1bb6499ee31adcf8b
|
| 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.1-py3-none-any.whl
| Download URL | healthcare_mcp-0.2.1-py3-none-any.whl |
|---|---|
| Size | 146.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
17b742c48a29af7e5ddc6c7fc564436a21effa2a3249292300612df3d952bbbc
|
|
BLAKE2b-256 checksum How to use checksums |
1c0e44d8c418d818c7b3f426e610a7a101b0bb9237ed94cee9d3301df683eb93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
