CONNECT CODEX

API KEYAbout 3 minutes · Free iPhone app

Codex plans your lifting. Tally logs every set.

Codex reads your training history. With a Read and plan key, it also writes planned workouts to the Tally app. With a Full access key, it can also log, change or delete finished workouts when you ask. You can undo each change for 7 days.

You are on a phone or tablet. Setting up Codex needs a computer, so do this in two parts.

02

Connect later on your computer

Opens the share sheet: AirDrop, Messages or Notes.

See the config
[mcp_servers.tally]
url = "https://mcp.tallyworkout.app/api/mcp"
bearer_token_env_var = "TALLY_API_KEY"
export TALLY_API_KEY=your-key

Use Claude on your phone instead? Connect Claude from its directory. No computer needed.

  1. 01

    Get Tally and create a key

    In Tally, open Settings → API keys → Create key. Pick Codex. Pick Read only, Read and plan so Codex can add workouts, or Full access so it can also log, change or delete finished workouts. You can undo each change for 7 days. Copy the key. Tally shows it once.

    Download on the App StoreQR code that opens Tally on the App Store. Scan it with your iPhone camera.Scan with your iPhone camera to open Tally on the App Store.
  2. 02

    Add this block to ~/.codex/config.toml

    [mcp_servers.tally]
    url = "https://mcp.tallyworkout.app/api/mcp"
    bearer_token_env_var = "TALLY_API_KEY"
  3. 03

    Put the key in your shell profile

    For example ~/.zshrc. Put your key in place of your-key.

    export TALLY_API_KEY=your-key
  4. 04

    Open a new terminal, then start Codex.

  5. 05

    Ask for your week

    Plan 4 lifting days for next week. Go easy on my shoulder.
An iPhone with Tally and a Codex chat that adds 4 workouts to Tally.

What Codex can do

  • Read your training history, progress and planned days
  • With a Read and plan key: plan, change, move or skip planned days
  • With a Full access key: log, change or delete finished workouts. You can undo each change for 7 days.
All 21 tools in the builder reference

If something goes wrong

Codex does not see Tally.
Open a new terminal after you edit your shell profile, so Codex can read TALLY_API_KEY.
Codex cannot add workouts.
The key is Read only. Create a new key and pick Read and plan.
The key does not work.
Copy the whole key. If you lost it, revoke it in Settings → API keys and create a new one. Tally shows a key only once.
The server address does not work.
Use https://mcp.tallyworkout.app/api/mcp. The address tallyworkout.app is the website, not the API.
Steps not working?
Email support@tallyworkout.app.

Other agents

Tally WorkoutFree · No ads
View in App Store