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.

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.