Skip to main content
Glama

Fitness Tools

CI License: MIT npm MCP Registry

πŸ“– Documentation Β· npm

Use it with your AI right now: add the hosted MCP connector https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp in claude.ai / ChatGPT settings, install one-click in Cursor or VS Code, or grab the Claude Desktop .mcpb.

Composable, deterministic fitness calculators β€” BMR/TDEE, body fat, 1RM, macros, activity multiplier, powerlifting attempts, and natural muscular potential. Each calculator runs several published formulas and reports a consensus across them.

This repo ships three separate, independently-usable artifacts:

  • @almostjacked/fitness-tools β€” the npm library. Validated, self-describing calculators that run natively in the browser and on the server. This is the product.

  • @almostjacked/fitness-tools-api β€” a reference HTTP server built on the library. It re-exposes the same calculators over HTTP (identical math, identical results) and is inert until you run or host it.

  • @almostjacked/fitness-tools-mcp β€” an MCP stdio server built on the library. It exposes the same calculators as MCP tools for agents/LLM clients (identical math), runnable with npx @almostjacked/fitness-tools-mcp.

Which one do you want?

You're…

Use

Why

Writing JS/TS (browser, Node, edge)

@almostjacked/fitness-tools (npm)

Runs in-process. Install, import, call. No server, no network.

Calling from another language / curl / a no-code tool

@almostjacked/fitness-tools-api (HTTP)

Same calculators over HTTP. You run/host it.

Building a remote frontend

@almostjacked/fitness-tools-api

Self-describing catalog + OpenAPI over the wire.

Wiring the calculators into an MCP client / agent

@almostjacked/fitness-tools-mcp

npx an MCP stdio server; one tool per calculator.

The API adds a network boundary, not capability. The package works the moment you install it; the server does nothing until it's running.

Documentation

Related MCP server: OpenGym Coach

Layout

packages/core   @almostjacked/fitness-tools β€” the library (the product)
apps/api        @almostjacked/fitness-tools-api  β€” a reference HTTP server over the library
apps/mcp        @almostjacked/fitness-tools-mcp  β€” an MCP stdio server over the library

Develop

corepack enable              # pnpm version is pinned in package.json
pnpm install
pnpm -r test                 # core + api + mcp test suites
pnpm -C packages/core build  # build the library
pnpm -C apps/api dev         # run the reference server on :8080

See each package's README β€” library Β· reference server.

License

MIT β€” free, open-source, and usable in commercial products. See LICENSE. Built on published formulas (Mifflin-St Jeor, US Navy, Jackson-Pollock, Epley, Casey Butt, etc.); contributions welcome.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides six deterministic, source-attributed hydration calculators (water intake, dehydration check, pregnancy intake, kidney-safe intake, athlete plan, energy optimization) as MCP tools, enabling AI clients to call them via stdio without custom HTTP coding.
      6
      51 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables ChatGPT to manage fitness routines, guided sessions, workout history, body weight tracking, and statistics through a remote authenticated MCP server with read and write tools.
      AGPL 3.0
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents and LLMs to retrieve precise food chemistry and nutrition data from USDA, Open Food Facts, and IFCT, evaluate recipes, optimize macros, look up barcodes, and detect ultra-processed foods through MCP tools.
      9
      MIT