Aidoo MCP Server

MCP Server für die Aidoo Fitnessstudio-Verwaltungssoftware. Ermöglicht den Zugriff auf Mitglieder, Verträge, Kurse, Buchungen und mehr direkt aus Claude heraus.

Voraussetzungen

1. Aidoo API-Zugang: Sie benötigen einen API-Key von Aidoo. Kontaktieren Sie dafür Burkhard Westermann (westermann@aidoo.de).

2. Node.js: Version 18 oder höher

Related MCP server: fitness-mcp-server

Installation

cd "/Users/rthode/projects/AIDOO MCP"
npm install
npm run build

Konfiguration

Umgebungsvariablen

Claude Desktop Konfiguration

Fügen Sie folgendes zu Ihrer Claude Desktop Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "aidoo": {
      "command": "node",
      "args": ["/Users/rthode/projects/AIDOO MCP/dist/index.js"],
      "env": {
        "AIDOO_API_KEY": "ihr-api-key-hier",
        "AIDOO_GYM_ID": "ihre-gym-id"
      }
    }
  }
}

Claude Code Konfiguration

Für Claude Code fügen Sie den Server in Ihre .mcp.json ein:

{
  "mcpServers": {
    "aidoo": {
      "command": "node",
      "args": ["/Users/rthode/projects/AIDOO MCP/dist/index.js"],
      "env": {
        "AIDOO_API_KEY": "ihr-api-key-hier",
        "AIDOO_GYM_ID": "ihre-gym-id"
      }
    }
  }
}

Verfügbare Tools

Mitglieder (Members)

Verträge (Contracts)

Kurse (Classes)

Buchungen (Bookings)

Studios (Gyms)

Trainer

Check-Ins

Webhooks

Statistiken

Beispiel-Anfragen

Mitglieder suchen

"Zeige mir alle Mitglieder mit Nachname Müller"
→ Nutzt aidoo_list_members mit lastname="Müller"

Auslaufende Verträge

"Welche Verträge laufen im nächsten Monat aus?"
→ Nutzt aidoo_get_expiring_contracts

Kursplan abrufen

"Zeige mir den Kursplan für diese Woche"
→ Nutzt aidoo_get_schedule

Webhook für Kündigungen

"Benachrichtige mich bei Vertragsänderungen"
→ Nutzt aidoo_create_webhook mit entity_name="contract"

Extensions (Verknüpfte Daten)

Die Aidoo API unterstützt das Laden verknüpfter Daten über den extensions Parameter:

aidoo_list_members mit extensions=["contracts", "bookings"]
→ Lädt Mitglieder inkl. deren Verträge und Buchungen

Mögliche Extensions je nach Entität:

• members: contracts, bookings, checkins

• contracts: member

• classes: trainer, room, bookings

• bookings: member, class

Entwicklung

# Development-Modus mit Hot-Reload
npm run dev

# Mit MCP Inspector testen
npm run inspect

Hinweise

• Die API ist auf maximal 100 Ergebnisse pro Anfrage begrenzt. Nutzen Sie limit und offset für Paging.

• Nach dem Erstellen eines Webhooks kann es bis zu 1 Minute dauern, bis er aktiv ist.

• Der API-Zugang erfordert eine Partnerschaftsvereinbarung mit Aidoo.

Lizenz

MIT