ofw-mcp

ofw-mcp

MCP server for OurFamilyWizard — provides read/write access to messages, calendar, expenses, and journal.

• npm: npmjs.com/package/ofw-mcp
• Source: github.com/chrischall/ofw-mcp

Setup

Option A — Claude Code (direct MCP, no mcporter)

Add to .mcp.json in your project or ~/.claude/mcp.json:

{
  "mcpServers": {
    "ofw": {
      "command": "npx",
      "args": ["-y", "ofw-mcp"],
      "env": {
        "OFW_USERNAME": "you@example.com",
        "OFW_PASSWORD": "yourpassword"
      }
    }
  }
}

Option B — mcporter

1. Install

npm install -g ofw-mcp

Or from source:

git clone https://github.com/chrischall/ofw-mcp
cd ofw-mcp
npm install && npm run build

2. Configure credentials

cp .env.example .env
# Edit .env: set OFW_USERNAME and OFW_PASSWORD

3. Register with mcporter

mcporter config add ofw \
  --command "ofw-mcp" \
  --env "OFW_USERNAME=you@example.com" \
  --env "OFW_PASSWORD=yourpassword" \
  --config ~/.mcporter/mcporter.json

4. Verify

mcporter list --config ~/.mcporter/mcporter.json
mcporter call ofw.ofw_get_profile --config ~/.mcporter/mcporter.json

Calling tools (mcporter)

mcporter call ofw.<tool_name> [key=value ...] --config ~/.mcporter/mcporter.json

Always pass --config ~/.mcporter/mcporter.json unless a local config/mcporter.json exists.

Tools

User

Tool	Description
ofw_get_profile	Current user + co-parent info (IDs, contact details)
ofw_get_notifications	Dashboard summary: unread count, upcoming events, outstanding expenses. ⚠️ Updates last-seen status.

Messages

Tool	Notes
ofw_sync_messages(folders?, deep?, fetchUnreadBodies?)	Sync OFW → local cache. Call first if the cache might be stale. Returns unread inbox hints (bodies not fetched, to avoid mark-as-read).
ofw_list_message_folders	List OFW folders with unread counts. Most reads use the cache; this is mainly for folder IDs and live unread counts.
ofw_list_messages(folderId?, since?, until?, q?, page?, size?)	Cache-backed list. Supports folder ("inbox"/"sent"/"both"), date range, and substring search.
ofw_get_message(messageId)	Read a message OR draft body. Cache-first. Ids in the drafts cache return folder: "drafts". ⚠️ Falls through to OFW for unread inbox messages, which marks them as read.
ofw_send_message(subject, body, recipientIds[], replyToId?, draftId?, myFileIDs?)	Send a message. Pass replyToId to thread original history. Pass draftId to auto-delete the draft after sending. Pass myFileIDs (from ofw_upload_attachment) to attach files.
ofw_get_unread_sent	Sent messages your co-parent hasn't read yet (from cache).
ofw_list_drafts	List saved drafts (cache-backed).
ofw_save_draft(subject, body, recipientIds?, messageId?, replyToId?, myFileIDs?)	Create a new draft. Pass messageId to replace an existing draft: the tool creates a fresh draft and deletes the old one (OFW's update-in-place endpoint silently no-ops). The returned id is the NEW id; the response includes a NOTE documenting the swap.
ofw_delete_draft(messageId)	Delete a draft.
ofw_upload_attachment(path, shareClass?, label?, description?)	Upload a local file to My Files; returns a fileId to pass into myFileIDs.
ofw_download_attachment(fileId, inline?, saveTo?, force?)	Download an attachment. inline:true returns bytes as MCP content; default writes to ~/Downloads/ofw-mcp/.

Calendar

Tool	Notes
ofw_list_events(startDate, endDate, detailed?)	Dates as YYYY-MM-DD
ofw_create_event(title, startDate, endDate, ...)	startDate/endDate as ISO datetime
ofw_update_event(eventId, ...)	Partial update — only pass fields to change
ofw_delete_event(eventId)	Permanent delete

Expenses

Tool	Notes
ofw_get_expense_totals	Summary of owed/paid totals
ofw_list_expenses(start?, max?)	Paginated; default max 20
ofw_create_expense(amount, description)	Log a new expense

Journal

Tool	Notes
ofw_list_journal_entries(start?, max?)	1-based offset; default max 10
ofw_create_journal_entry(title, body)	Create a new entry

Workflows

Check inbox:

1. ofw_list_message_folders → find inbox folder ID
2. ofw_list_messages(folderId) → list messages
3. ofw_get_message(messageId) → read a specific message

Send a message:

1. ofw_get_profile → get co-parent's user ID
2. ofw_send_message(subject, body, [coParentId])

Reply to a message (with thread history):

1. ofw_get_message(messageId) → read the message to reply to
2. ofw_send_message(subject, body, [coParentId], replyToId: messageId) — original message is included in the thread

Draft before sending (sensitive messages):

1. ofw_save_draft(subject, body) → review with user
2. ofw_send_message(..., draftId) after approval — draft is auto-deleted on send

Check what's coming up:

• ofw_get_notifications for a quick summary
• ofw_list_events(today, +30days) for calendar detail

Caution

• Always confirm before sending messages or deleting anything — OFW is a legal co-parenting record.
• ofw_get_notifications updates last-seen status — avoid calling silently in the background.
• ofw_get_message marks messages read — warn the user if they want to keep something unread.