GeniusFitness CLI & MCP

Manage your training plans, exercises and progress with your own AI tools. GeniusFitness keeps your programs and permissions in one place; your agent uses its own model and credentials.

Install and connect

Requires Node.js 22.13 or newer.

npm install --global @pulsarinteractive/geniusfitness@beta
geniusfitness auth login
geniusfitness whoami --json
geniusfitness programs list --json

Login opens your browser. Sign in to GeniusFitness, select programs and permissions, then approve. There is no token to copy into your terminal.

What you can do

| Feature | CLI | MCP | | ---------------------------------- | ------------------------------------- | ----------------------------------- | | Find your programs | programs list | fitness_programs | | Search exercises | catalog search --query squat | fitness_catalog | | Read workouts, planning or results | resources list | fitness_resources | | Summarize activity | metrics summary | fitness_metrics | | Create or edit a plan | commands prepare / commands retry | Journaled command tools | | Follow changes | changes list / changes watch | fitness_changes / fitness_watch |

Choose from the exercise catalogue before creating a custom exercise. Private health measurements require separate permission. Managing another athlete’s shared program also requires a Coach subscription and that athlete’s access grant.

Connect your agent

Authenticate once with the CLI, then configure your MCP client to run:

geniusfitness mcp --context default

Setup examples · Training workflow · Permissions and limits · Agent skills

Documentation

• CLI reference
• Authentication and account safety
• Contributing
• Security reports

MIT © Pulsar Interactive. This repository contains the public agent client and skills; the GeniusFitness application and service implementation are separate.