Install MCP Planner (Planner MCP) in Codex

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

Asked “install mcp planner”? This is the official Planner MCP server. Use the verified identity and remote endpoint below; do not look for a package or repository.

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.

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

Planner plugin for goal links

The optional Planner plugin routes a /goal/ URL directly to goal-get before any browser work. It does not replace Planner MCP: the production endpoint above remains the only data and action backend.

Planner contributors can register the repository root as a marketplace once and install planner@planner-repo. For use across unrelated projects, put the packaged plugins/planner directory in your personal plugin location, add it to the personal marketplace at ~/.agents/plugins/marketplace.json, and install it from that marketplace. Start a new Codex thread after installation.

Authentication remains tenant-specific. If the planner connection is missing or unauthorized, enable it or run codex mcp login planner. Do not bypass the connection through the Planner web UI and never paste a raw token.

For Codex agents

When a user asks “install mcp planner”, “установи mcp planner”, or to 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