ofw-mcp — Claude Code MCP server: what it does, how to install
Connects an OurFamilyWizard account to Claude to view co-parenting chats, track shared expenses, inspect schedules, and log journal notes.
claude mcp add --env OFW_USERNAME=<OFW_USERNAME> --env OFW_PASSWORD=<OFW_PASSWORD> --env OFW_WRITE_MODE=<OFW_WRITE_MODE> --env OFW_CALENDAR_WRITES=<OFW_CALENDAR_WRITES> --env OFW_ALLOW_MARK_READ=<OFW_ALLOW_MARK_READ> --transport stdio ofw-mcp -- npx -y ofw-mcpWhat ofw-mcp does
This server connects your AI client to OurFamilyWizard using the Model Context Protocol. You can inspect co-parenting correspondence, check activities on the children's calendar, tally pending family expenses, and draft journal notes about daily pickups. It relies on the built-in node:sqlite module to handle local caching.
Running the tool requires Node.js 22.5 or higher and an active OurFamilyWizard subscription. Authentication accepts credentials via OFW_USERNAME and OFW_PASSWORD, or reads an active browser session from Chrome through the ContextMint Bridge extension.
Entries in OurFamilyWizard carry legal weight in custody proceedings. Never let the agent send messages, log expenses, or write events without reviewing every line yourself. The codebase was generated by Claude Sonnet 4.6 and lacks human security auditing.
What it helps with
- check upcoming activities on the co-parenting calendar
- review unread messages from a co-parent
- calculate pending shares for logged family expenses
- draft a reply to the latest custody message
- record a parenting handoff entry in the journal
Example prompts for the agent
- Check my latest OurFamilyWizard messages and summarize them.
- What events are on the kids' schedule for next week?
- List recent expenses in OFW and calculate the balance I owe.
How to install ofw-mcp
Platform CLI
claude mcp add --env OFW_USERNAME=<OFW_USERNAME> --env OFW_PASSWORD=<OFW_PASSWORD> --env OFW_WRITE_MODE=<OFW_WRITE_MODE> --env OFW_CALENDAR_WRITES=<OFW_CALENDAR_WRITES> --env OFW_ALLOW_MARK_READ=<OFW_ALLOW_MARK_READ> --transport stdio ofw-mcp -- npx -y ofw-mcpReplace <…> with your own values. 20 more environment variables are in the server README
Platform CLI
codex mcp add ofw-mcp --env OFW_USERNAME=<OFW_USERNAME> --env OFW_PASSWORD=<OFW_PASSWORD> --env OFW_WRITE_MODE=<OFW_WRITE_MODE> --env OFW_CALENDAR_WRITES=<OFW_CALENDAR_WRITES> --env OFW_ALLOW_MARK_READ=<OFW_ALLOW_MARK_READ> -- npx -y ofw-mcpReplace <…> with your own values. 20 more environment variables are in the server README
Config file
{
"mcpServers": {
"ofw-mcp": {
"command": "npx",
"args": [
"-y",
"ofw-mcp"
],
"env": {
"OFW_USERNAME": "<OFW_USERNAME>",
"OFW_PASSWORD": "<OFW_PASSWORD>",
"OFW_WRITE_MODE": "<OFW_WRITE_MODE>",
"OFW_CALENDAR_WRITES": "<OFW_CALENDAR_WRITES>",
"OFW_ALLOW_MARK_READ": "<OFW_ALLOW_MARK_READ>"
}
}
}
}Replace <…> with your own values. 20 more environment variables are in the server README
Config file
{
"servers": {
"ofw-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ofw-mcp"
],
"env": {
"OFW_USERNAME": "<OFW_USERNAME>",
"OFW_PASSWORD": "<OFW_PASSWORD>",
"OFW_WRITE_MODE": "<OFW_WRITE_MODE>",
"OFW_CALENDAR_WRITES": "<OFW_CALENDAR_WRITES>",
"OFW_ALLOW_MARK_READ": "<OFW_ALLOW_MARK_READ>"
}
}
}
}Replace <…> with your own values. 20 more environment variables are in the server README
Platform CLI
gemini mcp add -e OFW_USERNAME=<OFW_USERNAME> -e OFW_PASSWORD=<OFW_PASSWORD> -e OFW_WRITE_MODE=<OFW_WRITE_MODE> -e OFW_CALENDAR_WRITES=<OFW_CALENDAR_WRITES> -e OFW_ALLOW_MARK_READ=<OFW_ALLOW_MARK_READ> ofw-mcp npx -y ofw-mcpReplace <…> with your own values. 20 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ofw-mcp
How do I install ofw-mcp in Claude Code?
Run `claude mcp add --env OFW_USERNAME=<OFW_USERNAME> --env OFW_PASSWORD=<OFW_PASSWORD> --env OFW_WRITE_MODE=<OFW_WRITE_MODE> --env OFW_CALENDAR_WRITES=<OFW_CALENDAR_WRITES> --env OFW_ALLOW_MARK_READ=<OFW_ALLOW_MARK_READ> --transport stdio ofw-mcp -- npx -y ofw-mcp`. Replace the placeholder brackets with your actual credentials.
What are the runtime requirements for ofw-mcp?
You need Node.js 22.5 or later because of the node:sqlite cache backend, alongside an active OurFamilyWizard account.
Can the agent safely submit messages without review?
No. OurFamilyWizard records act as court-admissible evidence in legal cases, so automated submissions can affect custody matters. Always inspect and approve write operations before committing them.
