Gymtracker

Universal MCP server + Claude Code plugin for Gymtracker. Lets AI coding agents (Claude Code, Codex, Cursor, …) read and write your training data.

What you need

• Your Gymtracker instance URL (GYMTRACKER_URL)
• An API token from your Gymtracker /api/tokens page (GYMTRACKER_TOKEN)

Modes

Env	Read	Write	Delete
(default)	✅	✅	❌
GYMTRACKER_ALLOW_DELETE=1	✅	✅	✅
GYMTRACKER_READONLY=1	✅	❌	❌

READONLY overrides ALLOW_DELETE.

Install

Claude Code (plugin)

/plugin marketplace add https://gitlab.com/codin-public/gymtracker-plugin.git
/plugin install gym@gymtracker

You'll be prompted for your URL and token. Adds /gym:log, /gym:summary, /gym:coach.

Codex CLI

See examples/codex.md.

Cursor / Claude Desktop / other MCP clients

See examples/cursor.md and examples/generic-mcp.json.

Gotchas

• Env is not inherited. stdio MCP servers don't see your shell env — put the vars in the client's env block (or Cursor's ${env:...}).
• npx on PATH. GUI clients launched from the Dock may not find npx (nvm/Homebrew). Use an absolute path to npx/node in command if startup fails.
• First run downloads. npx -y fetches the package once; bump Codex's startup_timeout_sec if it times out.

Development

npm install
npm test
npm run build

License

MIT