ofw-mcp

name: ofw-mcp description: This skill should be used when the user asks about OurFamilyWizard (OFW) co-parenting data. Triggers on phrases like "check OFW", "OurFamilyWizard inbox", "OFW messages", "OFW calendar", "OFW expenses", "what did my co-parent say", "log an expense in OFW", "OFW journal", or any request involving co-parenting messages, calendar events, shared expenses, or journal entries.

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:

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

Send a message:

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

Reply to a message (with thread history):

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

Draft before sending (sensitive messages):

ofw_save_draft(subject, body) → review with user
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.