LovedOne Family MCP

app.lovedonev0.3.0更新於 Oct 7, 2026

Family inbox: read records; invite, reply, mint codes. API key or OAuth care_circle:write.

已驗證Streamable HTTP可網頁執行Productivity & WorkflowCommunication & Collaboration

概覽

AI 產生的概覽

讓助理讀取家庭照護收件匣與紀錄、彙整訊息、邀請家人、產生服務方代碼並送出回覆。

功能
連線到為照顧年長父母家庭設計的 LovedOne Family Inbox 服務。讀取類工具可列出被照顧者、家庭成員、收件匣訊息與照護事件，並以純文字取得單一訊息。寫入類工具可透過電子郵件邀請家庭成員、產生短期服務方連結代碼，並對收件匣訊息送出純文字回覆。
適用情境
適合已在使用 LovedOne 收件匣的家庭，讓助理彙整來自醫師、藥局、保險公司或律師的來信、了解各人負責的事項，或起草並送出回覆。若未使用 LovedOne 則不需要加入。
執行需求
遠端 Streamable HTTP 端點，不需本機安裝套件。需要 LovedOne MCP 金鑰，以 Bearer 形式放在 Authorization 標頭中；寫入類工具也可使用帶 care_circle:write 範圍的 OAuth 2.1。寫入類工具還需要擁有者或協調者角色。
安裝前請注意
收件匣內容可能在主旨、預覽與本文中包含受保護的健康資訊，因此只連接你信任其處理這些資料的用戶端，並先查看其資料保留與訓練設定。Authorization 金鑰可讀取整個家庭工作區，請勿分享，並在用完後撤銷。邀請、服務方代碼與回覆工具會寫入並傳送資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 LovedOne Family MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "family-inbox": {
      "type": "http",
      "url": "https://api.lovedone.app/mcp/v1"
    }
  }
}

README

LovedOne MCP servers

This repo lists LovedOne's Model Context Protocol servers in the official MCP Registry. All three live under the app.lovedone/* namespace, which is lovedone.app written backwards.

ServerRegistry nameEndpointStatus
LovedOne Family Inboxapp.lovedone/family-inboxhttps://api.lovedone.app/mcp/v1Live
LovedOne Soft MCPapp.lovedone/softhttps://api.lovedone.app/mcp/vendor/v1Live
LovedOne Pipe MCPapp.lovedone/pipehttps://api.lovedone.app/mcp/pipe/v1 (planned)Not live yet

The public provider directory is a separate server, com.joinsandwich/directory (https://www.joinsandwich.com/api/mcp, no key needed). It isn't part of this repo.

This is a public listing repo (README, server.json files, LICENSE). The MCP servers are hosted at the endpoints above; their source is not in this repo.

LovedOne Family Inbox

The family inbox MCP for LovedOne, the family inbox for people caring for an aging parent. Each loved one gets a private @lovedone.app address for doctors, pharmacies, insurers, and attorneys, and every message lands in one inbox the whole family can see. This MCP lets an AI assistant summarize your own family's inbox and care records, invite family, mint provider codes, and reply to messages.

⚠️ Health information

LovedOne inboxes hold mail from doctors, pharmacies, and insurers, so responses can contain protected health information (PHI), including in message subjects, previews, and bodies.

  • Only connect LovedOne to an AI client you trust with that data, and check that client's data-retention and training settings first.
  • A key can read your whole family workspace. Don't share it, and revoke it at inbox.lovedone.app/settings/mcp-keys when you're done.
  • Write tools (invite, provider codes, replies) need an owner/coordinator and, for OAuth, the care_circle:write scope. Viewers stay read-only.

Authentication

  • API key (supported): create a key at inbox.lovedone.app/settings/mcp-keys and send it as Authorization: Bearer <key>.
  • OAuth 2.1: LovedOne runs an OAuth authorization server at https://inbox.lovedone.app (authorization code + PKCE, dynamic client registration). Public scopes: profile:read, care_circle:read, and care_circle:write. Write tools require care_circle:write on OAuth tokens; API keys skip the scope gate and use workspace role.

Connect

Cursor (~/.cursor/mcp.json or .cursor/mcp.json):

json
{  "mcpServers": {    "lovedone": {      "url": "https://api.lovedone.app/mcp/v1",      "headers": { "Authorization": "Bearer YOUR_LOVEDONE_KEY" }    }  }}

Claude Code:

bash
claude mcp add --transport http lovedone https://api.lovedone.app/mcp/v1 \  --header "Authorization: Bearer YOUR_LOVEDONE_KEY"

Claude Desktop (claude_desktop_config.json, via the mcp-remote bridge):

json
{  "mcpServers": {    "lovedone": {      "command": "npx",      "args": [        "-y", "mcp-remote", "https://api.lovedone.app/mcp/v1",        "--header", "Authorization:${AUTH_HEADER}"      ],      "env": { "AUTH_HEADER": "Bearer YOUR_LOVEDONE_KEY" }    }  }}

Then ask: "Summarize this week's messages in Mom's inbox and who's handling each one."

Tools

Read tools are scoped to the key owner's family workspace. Write tools need an owner/coordinator and OAuth care_circle:write when the caller is OAuth.

ToolWhat it does
pingSmoke test: returns the caller's uid, tenant, and auth method. No PHI.
get_user_profileThe signed-in user's profile and linked family workspace.
list_loved_onesLoved ones on the workspace: id, name, and Family Inbox address.
list_family_membersPeople on the workspace: role, relationship, invite status.
list_inbox_messagesRecent messages in one loved one's inbox (subject, sender, category, preview). May contain PHI.
get_inbox_messageOne message as plain text. May contain PHI.
list_care_eventsRecent care events, for one loved one or across the workspace.
invite_family_memberWrites. Invites a sibling or other family member by email (coordinator or viewer).
create_provider_codeWrites. Mints a short-lived Soft provider link code for one loved one.
reply_to_inbox_messageWrites. Sends a plaintext reply to a Family Inbox message. May contain PHI.

LovedOne Soft MCP

The developer MCP for care agencies on LovedOne Soft. One key covers one agency. Agents and developers can read the agency's clients, visits, and invoices, log visit notes, and schedule visits. A note on a client who is linked to a LovedOne family inbox is copied into that family's inbox. Auth is an agency API key or OAuth (profile:read, care_circle:read, care_circle:write).

  • 🌐 Endpoint: https://api.lovedone.app/mcp/vendor/v1 (Streamable HTTP, JSON-RPC 2.0)
  • ℹ️ Path note: the live Soft MCP is /mcp/vendor/v1, not /mcp/soft/v1 (that path is not an MCP route today). Family inbox is /mcp/v1, not bare /mcp.
  • 🔑 MCP key: sign in at soft.lovedone.app, then go to Settings → MCP keys
  • 📚 Docs: docs.lovedone.app/mcp-vendor · soft.lovedone.app/agents
  • 🗂️ Registry name: app.lovedone/soft
  • 📄 Listing file: soft/server.json

A family key on this endpoint (or an agency key on the family endpoint) is rejected with HTTP 403 WRONG_SURFACE.

⚠️ Visit notes can contain health information. The same rules as the family inbox apply: use a trusted client and revoke keys you no longer need.

Cursor:

json
{  "mcpServers": {    "lovedone-soft": {      "url": "https://api.lovedone.app/mcp/vendor/v1",      "headers": { "Authorization": "Bearer YOUR_SOFT_KEY" }    }  }}

Claude Code:

bash
claude mcp add --transport http lovedone-soft https://api.lovedone.app/mcp/vendor/v1 \  --header "Authorization: Bearer YOUR_SOFT_KEY"
ToolWhat it does
pingSmoke test: returns the caller's uid, tenant, and auth method. No PHI.
get_agency_profileThe agency: id, name, slug, plan, and the caller's role.
list_clientsThe agency's clients, and whether each is linked to a family inbox.
get_clientOne client plus recent visits and notes. May contain PHI.
list_visitsVisit and note events, for the agency or one client. May contain PHI.
add_visit_noteWrites. Logs a note on a client; copies it to a linked family inbox. OAuth needs care_circle:write.
schedule_visitWrites. Creates a scheduled visit for a client. OAuth needs care_circle:write.
list_invoicesInvoices the agency issued to families (amounts, status).

LovedOne Pipe MCP (coming later)

LovedOne Pipe MCP will connect LovedOne to healthcare systems, bringing partner events from EHR and EVV systems into a family's care record.

  • 🚧 Status: not live. https://api.lovedone.app/mcp/pipe/v1 is the planned endpoint and does not answer yet. Don't add it to a client.
  • 🗂️ Registry name (reserved): app.lovedone/pipe
  • 📄 Listing file: pipe/server.json, which won't be published until the endpoint is live.

Links

來源：README.md，提交 663071c

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.3.0最新Oct 7, 2026