TrueCal

npx add-mcp 'https://app.truecal.com/mcp'

Use TrueCal with your AI agent.

TrueCal is not just one app surface. Use it in the web app, mobile app, ChatGPT, Claude, Codex, Claude Code, Cursor, and any agent that can run terminal commands.

New to TrueCal? Start with the guides, compare plans on pricing, or check the FAQ before giving an agent access.

Install the npm package

Start read-only. Let your agent inspect profile, health context, targets, and meal history without giving it meal-write access.

npm install -g @truecal/cli
truecal help --json
truecal auth login --json
truecal agent enable codex --json
truecal agent doctor --profile codex --json --no-interactive

Headless or remote setup

If an agent cannot open a browser, use the device approval flow and approve the code inside TrueCal.

truecal agent enable codex --device --api-url https://app.truecal.com --json
# Approve the code at https://app.truecal.com/agent-cli/device
truecal agent doctor --profile codex --json --no-interactive

When you want writes

CLI meal logging requires explicit write access. The custom MCP integration also supports meal logging after account connection and write authorization, subject to account access.

truecal agent enable codex --scopes profile:read,health:read,meals:read,targets:read,meals:create --allow-mutate --json
truecal meals log --profile codex --allow-mutate --json --no-interactive --text "2 eggs, toast, and coffee"
truecal audit list --profile codex --json --no-interactive

ChatGPT and Claude connectors

ChatGPT app

See how to use TrueCal in ChatGPT.

Read how to add an MCP server to ChatGPT.

Custom MCP setup supports progress and selected weight and goal tools. Connected accounts can log meals, subject to account access and usage limits. The integration is not yet published in the ChatGPT plugin directory.

Claude connector

The custom MCP connector supports selected read, weight, and goal tools with your authorization. Connected accounts can log meals, subject to account access and usage limits.

Credential rules

• Use JSON output for agents.
• Keep credentials in the CLI store.
• Do not paste tokens into chat, notes, repo files, or logs.
• Use audit commands after write actions.

Agent FAQ

Can I use TrueCal from my AI agent?

Yes. Install @truecal/cli, authenticate once, and tell your agent to use JSON commands. This works with terminal-capable agents today.

Can an agent write to my TrueCal log?

Yes, but only after explicit write access. Start read-only, then grant write scopes when you want meal logging or other mutations.

Are ChatGPT and Claude public connectors live?

The integration is not yet published in the ChatGPT plugin directory. Custom MCP setup supports meal logging, progress, weight, and goal tools, subject to account access. The CLI is a separate integration for terminal-capable agents.