Set up Codex

Codex starts Bunplan's server only when it needs it. All Codex has to know is where that server is on your Mac, and the copied setup tells it.

Before you start

• Bunplan and Codex are both installed on this Mac.
• You have Bunplan Plus, or the free trial.

Add Bunplan to Codex

1. Open Bunplan, choose Bunplan → Settings, and click Assistants.
2. Under Access, choose Read only or Read & write. See Access and Plus.
3. Click Copy setup for other apps. Bunplan says "Setup copied".
4. Paste into a text editor and find the command line. Its value is the path to Bunplan's server on your Mac, ending in bunplan-mcp.
5. In Codex, add an MCP server with these details:

Field	Value
Name	bunplan
Type	Local (stdio)
Command	The path from step 4
Arguments	None

Try it

Start a new Codex session and ask:

• "What's on my plan today in Bunplan?"
• "Look at my Bunplan projects and tell me which deadline is closest."

Change or remove access

• To change what Codex may do, choose another access level in Bunplan → Settings → Assistants. It applies from the next request.
• To stop it for now, choose Off.
• To remove Bunplan, delete the bunplan server from Codex's MCP settings.

Every change Codex makes is listed in Bunplan → Settings → Assistants, with Undo. See Activity and Undo.

If it doesn't work

See Troubleshooting.