Codex Desktop can connect to Divorcepath when your organization wants a visible record of assistant requests, prepared work, approvals, and applied results. Divorcepath applies changes only after a user approves them.
Before you start
- Confirm that Codex Desktop is approved for your organization.
- Confirm that your Divorcepath organization has AI assistant access enabled.
- Open the AI Assistants page in Divorcepath (Integrations → AI Assistants), select OpenAI, then Codex, so you can copy the connection address and commands.
- Download the Divorcepath MCP skill package if you want Codex to use the prepared Divorcepath workflow guidance.
- Keep Codex approval prompts enabled.
Install the Divorcepath Codex skill
The skill teaches Codex how to use Divorcepath MCP for matter review, profile completion, finance updates, support calculations, financial statements, forms, agreements, artifacts, and the review gate. When you select OpenAI, then Codex, on the AI Assistants page, the Use the Divorcepath Codex skill panel shows the install command and a first Codex prompt.
- Run the install command below in your terminal. It downloads the package and unzips it into
~/.codex/skills. Or select Download skill on the AI Assistants page (or download the Divorcepath MCP skill package here) and unzip it into that folder yourself. Select Checksum to view the package version and checksum. - Restart Codex so the skill is available.
mkdir -p ~/.codex/skills
curl -L "https://www.divorcepath.com/downloads/skills/divorcepath-mcp-skill-v0.1.1.zip" -o /tmp/divorcepath-mcp-skill-v0.1.1.zip
unzip -o /tmp/divorcepath-mcp-skill-v0.1.1.zip -d ~/.codex/skills
The package does not contain organization details or credentials. Codex authorizes Divorcepath through the sign-in flow after the MCP server is added.
Add Divorcepath to Codex
On the AI Assistants page, select OpenAI, then Codex, and run the commands shown in step 1 in your terminal.
codex mcp add divorcepath --url "https://www.divorcepath.com/api/mcp"
codex mcp login divorcepath
You can also add a Divorcepath MCP server block to your Codex config instead.
[mcp_servers.divorcepath]
url = "https://www.divorcepath.com/api/mcp"
default_tools_approval_mode = "prompt"Confirm the connection
- Restart Codex after adding the connection.
- Run
/mcp. - If Codex has not already prompted you, use the login command from the setup block above. Codex opens the Divorcepath sign-in flow in your browser.
- Sign in to Divorcepath with your approved organization account. No API key is needed.
- Confirm Divorcepath appears as an available connection.
- Ask a read-only question first, using the verification prompt from step 3 on the AI Assistants page:
Use only the Divorcepath MCP for Divorcepath data. List the available Divorcepath actions and summarize the approval rules. Explain what information is required to search clients, but do not retrieve or display any client, matter, or party records. Do not prepare, approve, or apply any changes.Share client files with Codex
Codex can work only with the client files you share with it. Return to the AI Assistants page and, under Assistant access to your files, choose the Codex connection in Connected assistant, find a client file, and select Share selected file. To let Codex prepare updates for that file, select Also allow proposed updates and document changes before you share it. See Choose which files an assistant can access.
Recommended test prompt
After you share a non-sensitive sample client file with proposed updates allowed, try this prompt:
Use only the configured Divorcepath MCP server for Divorcepath data.
List the available Divorcepath actions and summarize the approval rules.
Read one matter summary, list missing profile and finance facts,
prepare a sample preview that does not change a matter, and stop for user review.
Give me the Divorcepath review link and do not treat anything as saved until I approve it there.Skill-enabled prompt
After installing the skill, you can ask Codex to use the Divorcepath workflow directly. This is the first Codex prompt shown in the Codex skill panel:
Use $divorcepath-mcp.
Review this Divorcepath matter for party, child, relationship, finance, disclosure, calculation, and document readiness.
Tell me what is missing and what work product can be prepared.
If one safe update is clear from the facts I provide, prepare it as a reviewed preview and stop for approval.Setup checklist
- Codex can discover Divorcepath in
/mcp. - Codex can read a client file you shared with it, and its calculations, documents, or setup details.
- Codex can prepare a sample preview that does not change a matter.
- Codex gives you a Review and approve in Divorcepath link for the preview.
- Nothing is saved until you approve on that page.
- Codex can discard work you decided against.
- After you approve a sample preview, Codex can confirm the result.
Useful Codex workflows
Codex is especially useful when you want a visible transcript of the request, tool calls, review step, and result.
- ask Codex to inspect matter readiness before preparing updates
- update a party profile, relationship fact, child record, income source, asset, debt, or child expense from user-provided facts
- review a support calculation and prepare a calculation update preview
- search financial statement and court-form templates across supported jurisdictions
- generate selected court forms or specialized Ontario Form 13, Form 13.1, Form 13B, or Form 13C documents after reviewing readiness warnings
- retrieve calculation summaries, available calculation PDFs, generated Word documents, and inline document summaries
Review this matter for support-calculation and financial-statement readiness.
Find the relevant court-form templates for the matter's jurisdiction.
Show me the missing facts and recommended next actions.
If one safe update is clear from the facts I provide, prepare it for review.
Give me the Divorcepath review link and do not treat anything as saved until I approve it there.Where Codex fits
Use Codex when your organization wants a clear record of requests, previews, approvals, and results. The same Divorcepath review rule applies regardless of which approved AI assistant you use.
