Connect GoalNexa to Codex CLI

Last updated 2026-10-17

GoalNexa tracks goals with measurable numbers and forecasts whether each one lands by its date. Connected to Codex CLI, you can plan a goal, log progress and review how you're doing by just asking - "ran 12 km today" is a check-in. A config file; the token comes from an environment variable.

What you need

  • A GoalNexa account - the free plan is enough, and the AI connection is in every plan.
  • Codex CLI (terminal). A personal access token from the MCP access page.

Connect

  1. Create your free account, then on the MCP access page create a personal access token. It replaces <your-token> below (the page can also fill it in for you).
  2. Add this to ~/.codex/config.toml (codex mcp add <name> --url <url> --bearer-token-env-var <VAR> writes the same thing).
    # ~/.codex/config.toml
[mcp_servers.goalnexa]
url = "https://goal.pmnexa.com/api/v1/mcp"
bearer_token_env_var = "GOALNEXA_MCP_TOKEN"

# ~/.zshrc or ~/.bashrc
# export GOALNEXA_MCP_TOKEN="<your-token>"
  3. Codex reads the token from an environment variable, so export it in your shell profile.
  4. Optional: ask your assistant to Install the goalnexa skills from https://goal.pmnexa.com/api/v1/mcp/skills - it then knows how to plan, check in and review.

Check it worked: Run codex mcp list, or /mcp inside a session.

Things to try

  • "I want to run a half marathon by November - set it up as a goal."
  • "Ran 12 km this morning."
  • "We're at 420 beta users."
  • "How are my goals doing this week?"

Codex CLI acts as you, with exactly your access, and answers in your language. Check-ins it makes are marked "AI agent" in the goal's activity. Revoke access any time on the MCP access page.

Other assistants

Claude · ChatGPT · Gemini · Cursor · VS Code · Windsurf · Claude Code · Gemini CLI · Claude Desktop · All guides

Support

Stuck? Email xuanbinh91@gmail.com or see the contact page.