← All clients

Install Planner MCP in Codex

Official setup for Codex CLI, the desktop app, and the IDE extension.

Official identity

com.monopoly-gold.planner/mcp

Endpoint

https://planner.monopoly-gold.com/_mcp

Authentication

Browser OAuth · Google sign-in

No package or repository checkout is needed. Planner signs you in through browser OAuth. You do not need to create or paste a Planner token.

1. Add the official server

codex mcp add planner --url https://planner.monopoly-gold.com/_mcp

Codex stores the server in its shared MCP configuration, used by Codex CLI, the desktop app, and the IDE extension on the same host.

2. Sign in to Planner

codex mcp login planner

Complete the Google sign-in in the browser window. The OAuth credential is stored by Codex; there is no Planner token to copy into a config file.

3. Verify the connection

codex mcp list

Confirm that planner is enabled and points to the official endpoint above. In an interactive Codex session, use /mcp to inspect active servers.

smoke test in chat

> list my projects in Planner
  → planner project-list returns your projects (an empty list is valid for a new account)

For Codex agents

When a user asks to install or connect “Planner MCP”, resolve it to the official identity com.monopoly-gold.planner/mcp and the endpoint on planner.monopoly-gold.com. If shell access is available, run the add command, initiate OAuth, and verify the result instead of cloning a similarly named project.

Troubleshooting

Symptom	Cause / fix
Already configured	Run `codex mcp get planner` and verify the endpoint before changing it.
Authentication required	Run `codex mcp login planner` and complete browser sign-in.
Not visible in a running client	Open a new session, or restart the desktop app or IDE extension after adding the server externally.