fitbot-mcp

Servidor MCP para AimHarder: reserva clases, consulta el horario y cancela reservas desde cualquier cliente MCP (Claude Desktop, Claude Code, etc.).

API no oficial, obtenida por ingeniería inversa de la web. Puede dejar de funcionar si AimHarder cambia sus endpoints. Úsalo solo con tu propia cuenta.

Herramientas

Herramienta	Qué hace
list_classes	Lista las clases de un día: hora, nombre, coach, plazas y si estás apuntado.
book_class	Reserva una clase por hora ("18:15") o por classId. insist=true → lista de espera.
cancel_class	Cancela tu reserva en una clase.
class_attendees	Lista los apuntados a una clase. Solo para cuentas coach/admin (ver nota abajo).
list_boxes	Muestra los boxes de tu cuenta y su boid.

Todas aceptan date (YYYY-MM-DD, por defecto hoy) y, si perteneces a varios boxes, boxId.

Configuración

Credenciales por variables de entorno: AIMHARDER_EMAIL y AIMHARDER_PASSWORD.

No hace falta clonar el repo: puedes ejecutarlo directamente con npx.

Opción 1 — directo desde GitHub (sin publicar en npm)

npx clona y compila el paquete la primera vez (script prepare). Añade a tu claude_desktop_config.json (Claude Desktop) o .mcp.json (Claude Code):

{
  "mcpServers": {
    "fitbot": {
      "command": "npx",
      "args": ["-y", "github:alliso/fitbot-mcp"],
      "env": {
        "AIMHARDER_EMAIL": "tu@email.com",
        "AIMHARDER_PASSWORD": "tu_contraseña"
      }
    }
  }
}

Opción 2 — desde npm (si lo publicas)

Tras npm publish --access public, la config es aún más corta:

{
  "mcpServers": {
    "fitbot": {
      "command": "npx",
      "args": ["-y", "fitbot-mcp"],
      "env": {
        "AIMHARDER_EMAIL": "tu@email.com",
        "AIMHARDER_PASSWORD": "tu_contraseña"
      }
    }
  }
}

Opción 3 — instalación local (desarrollo)

git clone https://github.com/alliso/fitbot-mcp.git
cd fitbot-mcp && npm install && npm run build

y usa "command": "node", "args": ["/ruta/a/fitbot-mcp/dist/index.js"].

Reinicia el cliente y pídele, por ejemplo: "reserva la clase de CrossFit de mañana a las 18:15".

Modo HTTP (para n8n y otros clientes remotos)

Además de stdio, el server puede arrancar como servicio HTTP con URL propia (transporte Streamable HTTP del MCP SDK), sin necesidad de gateways.

# desde el repo (o npx -y github:alliso/fitbot-mcp --http)
AIMHARDER_EMAIL=tu@email.com AIMHARDER_PASSWORD=tu_contraseña \
  PORT=8000 HOST=0.0.0.0 \
  node dist/index.js --http

Endpoint MCP: http://<host>:8000/mcp — y GET /health para healthcheck.

Variables de entorno:

Var	Por defecto	Descripción
PORT	8000	Puerto de escucha.
HOST	127.0.0.1	Interfaz. Usa 0.0.0.0 en Docker/contenedores.
MCP_HTTP_PATH	/mcp	Ruta del endpoint.
MCP_HTTP_TOKEN	—	Si se define, exige Authorization: Bearer <token>. Recomendado si el puerto es accesible por la red.

También puedes activarlo con MCP_TRANSPORT=http en vez del flag --http.

Conectarlo desde n8n (self-hosted)

1. Arranca el server en modo HTTP en una máquina accesible desde n8n (mismo host, otra máquina de la red, o un contenedor en el mismo docker-compose).
2. En n8n, dentro de tu AI Agent, añade el nodo MCP Client Tool.
3. Transporte HTTP Streamable (o SSE, según versión) y Endpoint: http://<host>:8000/mcp
   • Si defines MCP_HTTP_TOKEN, añade en el nodo la cabecera Authorization: Bearer <token>.
4. Si n8n corre en Docker y el server en el host, usa http://host.docker.internal:8000/mcp.

Alternativa sin modo HTTP: el community node n8n-nodes-mcp permite conexión STDIO con command: npx, args: -y github:alliso/fitbot-mcp y las variables de entorno de credenciales (requiere Node/npx dentro del contenedor de n8n).

Ejemplos de uso (lenguaje natural)

• "¿Qué clases hay hoy?" → list_classes
• "Apúntame al WOD de las 18:15" → book_class { time: "18:15" }
• "Cancela mi reserva de las 18:15" → cancel_class { time: "18:15" }
• "¿Quién va a la clase de las 18:15?" → class_attendees (ver nota)

Notas

• Apuntados a una clase: AimHarder solo expone la lista de asistentes a cuentas con rol coach/administrador en el box. Para cuentas de cliente el endpoint (/api/coachBookings) devuelve vacío, y class_attendees lo indica en su respuesta.
• Fingerprint: en el primer arranque se genera un identificador de dispositivo estable y se guarda en ~/.fitbot-mcp/fingerprint (en tu carpeta de usuario, para que persista aunque se ejecute vía npx). Puedes fijarlo con la variable AIMHARDER_FINGERPRINT.
• Multi-box: si tu cuenta pertenece a varios boxes, usa list_boxes para ver los boid y pasa boxId a las demás herramientas.

API (referencia interna)

• Login: POST https://login.aimharder.com/api/login — JSON { username, password, fingerprint, iniframe: 0 }. Devuelve data.userData.roles[].boid / centre_url y cookies de sesión (.aimharder.com).
• Horario: GET https://{subdominio}/api/bookings?day=YYYYMMDD&box={boid}&familyId=
• Reservar: POST https://{subdominio}/api/book — form { id, day, insist, familyId }. bookState: 1/0 ok · -1 llena · -2 sin tarifa · -4/-7 antelación · -5 pago pendiente.
• Cancelar: POST https://{subdominio}/api/cancelBook — form { id: idres, late, familyId }. cancelState: 1 = ok.