incremnt

Command-line tool and MCP server for querying your incremnt strength training data.

Requires the incremnt iOS app — all workout data originates there.

Setup

npm install -g incremnt
incremnt login
incremnt mcp install   # registers with Claude Desktop, Claude Code, and Codex CLI

This gives you two commands: incremnt (CLI) and incremnt-mcp (MCP server). The mcp install step auto-registers the MCP server with Claude Desktop, Claude Code, and Codex CLI — restart your AI assistant for it to take effect.

CLI

Hosted sync (recommended)

After connecting with Apple in the iOS app (Settings > Cloud Sync), your workouts sync automatically. To access them from the CLI:

incremnt login
incremnt sessions list --limit 5
incremnt records
incremnt records --pretty
incremnt programs current
incremnt exercises history --name "Bench Press"

Local snapshot

If you prefer to work offline, export a snapshot from the app and point the CLI at it:

incremnt sessions list --input ~/Downloads/export.onemore.json --limit 5
incremnt records --input ~/Downloads/export.onemore.json --pretty

If --input is omitted, the CLI checks INCREMNT_SNAPSHOT, then ONEMORE_SNAPSHOT, then common local paths, then the most recent .onemore.json in ~/Downloads.

Commands

| Command | Description | |---------|-------------| | sessions list | Recent sessions with duration and exercise count | | sessions show --id <id> | Details for a single session | | programs current | Active program state | | programs list | All programs | | cycles list [--program-id <id>] | Completed cycle summaries | | cycles show --id <id> | Details for a completed cycle summary | | exercises history --name <name> | Set-by-set history for an exercise | | records | Personal records (best e1RM per exercise) | | login | Authenticate with the hosted sync service | | logout | Clear stored session | | status | Show current mode, auth state, and config paths | | contract | Machine-readable command surface for scripts |

Flags

| Flag | Description | |------|-------------| | --pretty | Human-readable formatted output (default is JSON) | | --input <path> | Path to a local .onemore.json snapshot | | --limit <n> | Limit number of results (for sessions list) | | --program-id <id> | Filter cycle summaries to a program |

Exercise matching

exercises history --name "Bench Press" uses canonical synonym matching, so it finds Barbell Bench Press without pulling in incline, machine, or dumbbell variants.

MCP Server

The package includes an MCP server that exposes the same read queries and program proposal commands as tools for AI assistants like Claude.

Run incremnt mcp install to auto-register the server with Claude Desktop, Claude Code, and Codex CLI (see Setup above).

To register manually instead, add to your Claude Code project config (.mcp.json):

{
  "mcpServers": {
    "incremnt": {
      "type": "stdio",
      "command": "incremnt-mcp"
    }
  }
}

The MCP server uses the same auth session as the CLI — run incremnt login first.

License

MIT