Client guide

Human Design MCP for Codex.

Register the remote server in Codex and authenticate through HumanDesign.ai OAuth.

Recommended: connect your HumanDesign.ai account

  1. Add the canonical remote endpoint https://mcp.humandesign.ai/ without a static API-key header.
  2. Start the client's OAuth login and complete the branded HumanDesign.ai browser flow.
  3. Review the membership-aware tools returned after reconnect.

Codex OAuth setup

[mcp_servers.human_design_ai]
url = "https://mcp.humandesign.ai/"
auth = "oauth"
startup_timeout_sec = 30
tool_timeout_sec = 60

After saving the TOML, run codex mcp login human_design_ai. The ChatGPT desktop app, Codex CLI, and Codex IDE extension share the same Codex-host MCP configuration.

OAuth visibility follows HumanDesign.ai Free/Individual/Personal/Pro membership and entitlements. API-key visibility follows the separate Free/Creator/Startup/Business API plan. Neither credential type bypasses ownership or quota checks.

Verify the connection

Run tools/list and confirm the catalog matches the account boundary; discovery is free. Ask for “my chart” and verify the client uses chart_get_primary, not a name search. If none exists, ask it to preview chart_generate and confirm only after checking the normalized birth details and one-unit quota estimate. Then request a PNG and confirm either the inline image or its short-lived download link appears. Personal or Pro is required for other people's authorized charts.

Download the plugin and setup files →