The config
[mcp_servers.hoist_assets]
command = "npx"
args = ["-y", "@hoist-assets/mcp"]Steps
- Install Codex CLI:
npm i -g @openai/codex. - Add the snippet to
~/.codex/config.toml. Codex spawns the MCP server as a subprocess via npx. - Run:
codex --mcp hoist_assets. First run prompts you to approve OAuth in a browser.
Smoke test
In a Codex session: "Run a PPSR search on ACN 123 456 789." Codex routes to hoist-assets and confirms the price before executing.
Troubleshooting
- OAuth window doesn't open. Check your default browser is set and pop-ups aren't blocked. On macOS you may need to grant Codex CLI accessibility permissions.
- Tools don't appear after install. Restart the host completely. Some hosts cache the tool list at startup.
- 403 on calls. Re-approve OAuth — the cached token may have expired or had scopes revoked.
- Still stuck? Drop a note on GitHub Issues with the host name and the error message.