lovedone-mcp

Stdio MCP proxy for LovedOne Family MCP (app.lovedone/family-inbox). It does not reimplement tools. It forwards JSON-RPC to the live remote:

https://api.lovedone.app/mcp/v1

This is the family product (one household inbox). It is not LovedOne Soft MCP (providers) and not the Sandwich public directory.

| | | |---|---| | Version | 0.3.1 (matches live Family MCP) | | Registry | app.lovedone/family-inbox | | Remote | https://api.lovedone.app/mcp/v1 | | Auth | Authorization: Bearer sk-sand-… | | Env | LOVEDONE_API_KEY | | Mint key | inbox.lovedone.app/settings/mcp-keys | | Sibling | lovedone-soft-mcp → Soft portal → Settings → MCP keys |

A Soft / agency key on this surface is HTTP 403 WRONG_SURFACE, not a silent mix-up.

Mint a key

1. Sign in at inbox.lovedone.app.
2. Open Settings → MCP keys (direct link).
3. Create a key and copy the plaintext once. It starts with sk-sand-.
4. Set LOVEDONE_API_KEY in your MCP client. Do not commit the key.

If you lose the plaintext, mint a new key and revoke the old one.

Cursor

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

{
  "mcpServers": {
    "lovedone-family": {
      "command": "npx",
      "args": ["-y", "lovedone-mcp"],
      "env": {
        "LOVEDONE_API_KEY": "sk-sand-REPLACE"
      }
    }
  }
}

Claude Desktop / Claude Code

~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "lovedone-family": {
      "command": "npx",
      "args": ["-y", "lovedone-mcp"],
      "env": {
        "LOVEDONE_API_KEY": "sk-sand-REPLACE"
      }
    }
  }
}

npx -y lovedone-mcp

The process exits with a clear error if LOVEDONE_API_KEY is missing. It will not fall back to SANDWICH_SOFT_API_KEY.

Remote HTTP (no npx)

Clients that speak Streamable HTTP can skip this package:

{
  "mcpServers": {
    "lovedone-family": {
      "url": "https://api.lovedone.app/mcp/v1",
      "headers": {
        "Authorization": "Bearer sk-sand-REPLACE"
      }
    }
  }
}

Tools

Tools live on the remote. Typical family tools: ping, get_user_profile, list_loved_ones, list_family_members, list_inbox_messages, get_inbox_message, list_care_events, invite_family_member, create_provider_code, reply_to_inbox_message. HTML email is never returned. Viewers cannot run the write tools.

Docs

• Family spec
• Hub
• In-product

License

MIT