Skip to main content
Glama

TrackingTime MCP-Server

Ein MCP (Model Context Protocol)-Server, der KI-Assistenten wie Claude mit der TrackingTime-API v4 verbindet. Verwalten Sie Projekte, Aufgaben, Zeiterfassung, Personalzuweisungen und Kunden mithilfe natürlicher Sprache.

Schnellstart

1. Holen Sie sich Ihre TrackingTime-Zugangsdaten

  • App-Passwort: TrackingTime → Verwalten → Benutzereinstellungen → Apps & Integrationen → neues App-Passwort erstellen

  • Account-ID: Sichtbar in Ihrer TrackingTime-URL, wenn Sie eingeloggt sind, oder in den Kontoeinstellungen

2. Zu Ihrem KI-Assistenten hinzufügen

Claude Code:

claude mcp add trackingtime -e TT_APP_PASSWORD=your-app-password -e TT_ACCOUNT_ID=your-account-id -- npx trackingtime-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "trackingtime": {
      "command": "npx",
      "args": ["trackingtime-mcp"],
      "env": {
        "TT_APP_PASSWORD": "your-app-password",
        "TT_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

Starten Sie Ihren Assistenten nach dem Hinzufügen neu.

Alternative: Installation aus dem Quellcode

Wenn Sie das Repository lieber klonen und lokal bauen möchten:

git clone https://github.com/ficus33/trackingtime-mcp.git
cd trackingtime-mcp
npm install
npm run build
cp .env.example .env   # then edit .env with your credentials

Verweisen Sie dann Ihren Assistenten auf den lokalen Build:

claude mcp add trackingtime -- node /path/to/trackingtime-mcp/dist/index.js

Related MCP server: Clockify MCP Server

Tools

Projekte

Tool

Beschreibung

tt_list_projects

Projekte auflisten (Filter: ACTIVE/ARCHIVED/ALL/FOLLOWING)

tt_list_project_ids

Nur Projekt-IDs auflisten (leichtgewichtig, für Batch-Operationen)

tt_search_projects

Projekte und Aufgaben nach Stichwort suchen

tt_create_project

Ein neues Projekt erstellen

tt_update_project

Projektname, Kunde oder Dienstleistung bearbeiten

tt_update_project_preferences

Favoriten, Standardansicht, geschlossene Aufgaben anzeigen festlegen

tt_get_project

Einzelnes Projekt mit Detail-Flags abrufen

tt_get_project_times

Akkumulierte Zeit für mehrere Projekte abrufen

tt_get_project_users

Sehen, welche Mitarbeiter an einem Projekt arbeiten

tt_archive_project

Ein Projekt archivieren (umkehrbar)

tt_reopen_project

Ein archiviertes Projekt wieder öffnen

tt_delete_project

Ein Projekt dauerhaft löschen

tt_merge_projects

Ein Projekt in ein anderes zusammenführen

Aufgaben

Tool

Beschreibung

tt_list_tasks

Aufgaben auflisten (Filter: ACTIVE/ARCHIVED/ALL/TRACKING)

tt_create_task

Aufgabe mit Zuweisungen, Fälligkeitsdatum, Schätzung erstellen

tt_update_task

Aufgabe bearbeiten oder Personal neu zuweisen

tt_get_task

Details einer einzelnen Aufgabe abrufen

tt_get_task_times

Akkumulierte Zeiten für mehrere Aufgaben abrufen

tt_search_tasks

Aufgaben nach Name innerhalb von Projekten suchen

tt_sort_tasks

Aufgaben nach Sortierindex neu anordnen

tt_import_tasks

Aufgaben im Bulk importieren mit Vorschau-Modus

tt_close_task

Eine Aufgabe als abgeschlossen markieren

tt_reopen_task

Eine abgeschlossene Aufgabe wieder öffnen

tt_delete_task

Eine Aufgabe löschen

Zeiterfassung

Tool

Beschreibung

tt_start_timer

Timer für eine Aufgabe starten

tt_stop_timer

Laufenden Timer stoppen

Zeiteinträge

Tool

Beschreibung

tt_list_time_entries

Einträge nach Benutzer/Projekt/Kunde/Aufgabe + Datumsbereich auflisten

tt_list_time_entries_min

Leichtere minimale Liste (Abrechnungsfilter, Abwesenheiten)

tt_count_time_entries

Schnelle Anzahl der Einträge für einen Filter

tt_add_time_entry

Manuellen Zeiteintrag hinzufügen (Dauer in Sekunden)

tt_get_time_entry

Einen einzelnen Zeiteintrag abrufen

tt_update_time_entry

Einen Zeiteintrag bearbeiten

tt_delete_time_entry

Einen Zeiteintrag löschen

tt_get_events_summary

Zusammenfassung der Stunden pro Benutzer pro Tag

tt_export_time_entries

Als CSV exportieren

tt_mark_billed

Einträge als abgerechnet markieren

tt_mark_not_billed

Abrechnungsmarkierung von Einträgen entfernen

Event-Tags

Tool

Beschreibung

tt_list_tags

Alle Tag-Definitionen auflisten

tt_get_tag

Einen einzelnen Tag abrufen

tt_list_tag_values

Werte auflisten, die für einen Tag-Namen verwendet werden

tt_create_tag

Eine Tag-Definition erstellen

tt_update_tag

Einen Tag aktualisieren

tt_delete_tag

Eine Tag-Definition löschen

tt_save_event_tag

Tag an einen Zeiteintrag anhängen/aktualisieren

tt_delete_event_tag

Tag von einem Zeiteintrag entfernen

Benutzer & Personal

Tool

Beschreibung

tt_list_users

Alle Mitarbeiter auflisten (Benutzer-IDs finden)

tt_get_user

Details eines einzelnen Benutzers abrufen

tt_create_user

Benutzer erstellen (ersetzt das entfernte tt_invite_users)

tt_update_user

Benutzerprofil aktualisieren

tt_update_user_permissions

Granulare Bearbeitungs-/Ansichtsberechtigungen festlegen

tt_update_employee

HR-Felder aktualisieren (Jobtitel, Abteilung, Daten...)

tt_resend_invite

Aktivierungs-E-Mail an ausstehenden Benutzer erneut senden

tt_reset_icalendar_token

iCal-Export-Token des Benutzers rotieren

tt_get_user_tasks

Aufgaben eines Benutzers gruppiert nach Projekt auflisten

tt_get_user_tracking

Sehen, was ein Benutzer gerade erfasst

tt_get_user_trackables

Alle Projekte und Aufgaben, die einem Benutzer zugewiesen sind

tt_get_user_projects

Projekte auflisten, die einem Benutzer zugewiesen sind

tt_assign_user_projects

Personal Projekten zuweisen

tt_remove_user_projects

Personal von Projekten entfernen

tt_archive_user

Benutzer deaktivieren (nur Admin)

tt_reactivate_user

Einen archivierten Benutzer reaktivieren

Benutzergruppen

Tool

Beschreibung

tt_list_user_groups

Gruppen auflisten (Filter: ACTIVE/ARCHIVED/ALL)

tt_get_user_group

Eine einzelne Gruppe abrufen

tt_create_user_group

Gruppe erstellen (Supervisor + Mitglieder erforderlich)

tt_update_user_group

Gruppe aktualisieren (Archivierung über status: "ARCHIVED")

tt_delete_user_group

Eine Gruppe dauerhaft löschen

Kunden

Tool

Beschreibung

tt_list_customers

Kunden auflisten (Filter: ACTIVE/ARCHIVED/ALL)

tt_get_customer

Details eines einzelnen Kunden abrufen

tt_create_customer

Einen neuen Kunden erstellen

tt_update_customer

Kundendetails bearbeiten

tt_delete_customer

Einen Kunden dauerhaft löschen

tt_archive_customer

Einen Kunden archivieren (umkehrbar)

tt_reactivate_customer

Einen archivierten Kunden reaktivieren

Dienstleistungen

Tool

Beschreibung

tt_list_services

Dienstleistungen auflisten (Arbeitskategorien)

tt_get_service

Eine Dienstleistung abrufen

tt_create_service

Eine neue Dienstleistung erstellen

tt_update_service

Eine Dienstleistung aktualisieren

tt_archive_service

Eine Dienstleistung archivieren (umkehrbar)

tt_reactivate_service

Eine archivierte Dienstleistung reaktivieren

tt_delete_service

Eine Dienstleistung dauerhaft löschen

Teams (Arbeitsbereiche)

Tool

Beschreibung

tt_list_teams

Alle Arbeitsbereiche auflisten, denen der Benutzer angehört

tt_switch_team

Den aktiven Arbeitsbereich für die Sitzung wechseln

tt_update_team_permissions

Standard-Mitgliederberechtigungen aktualisieren

Berichte

Tool

Beschreibung

tt_get_user_report

Analysebericht pro Benutzer mit Diagrammen und Aufschlüsselungen

Benachrichtigungen

Tool

Beschreibung

tt_list_notifications

Benachrichtigungen auflisten (USER- oder PROJECT-Bereich)

tt_mark_notification_read

Eine Benachrichtigung als gelesen markieren

tt_mark_notifications_read

Viele Benachrichtigungen als gelesen markieren

Webhooks

Tool

Beschreibung

tt_list_webhooks

Konfigurierte Webhooks auflisten

tt_get_webhook

Einen Webhook abrufen

tt_enable_webhook

Einen Webhook aktivieren

tt_disable_webhook

Einen Webhook deaktivieren

tt_reset_webhook_token

Signatur-Token eines Webhooks rotieren

tt_delete_webhook

Einen Webhook löschen

Reduzierung der Tool-Anzahl

Alle 93 Tools sind standardmäßig aktiv. Wenn dies zu viel Kontext für Ihren KI-Assistenten erzeugt, können Sie das Repository klonen, nicht benötigte Tools in src/tools.ts mit /* */ auskommentieren und npm run build ausführen, um einen schlankeren Build zu erstellen.

Testen

Verwenden Sie den MCP Inspector, um Tools interaktiv zu testen:

npx @modelcontextprotocol/inspector npx trackingtime-mcp

API-Hinweise

Einige Besonderheiten der TrackingTime-API, die Sie beachten sollten:

  • duration und accumulated_time sind in Sekunden angegeben

  • estimated_time und worked_hours sind in Stunden angegeben

  • Zeiteinträge werden in der API als "events" bezeichnet

  • Das Starten eines Timers, während bereits einer läuft, gibt den Fehler 502 zurück — verwenden Sie stop_running_task=true, um den aktuellen Timer automatisch zu stoppen

  • Datumsangaben verwenden YYYY-MM-DD, Datums-Zeit-Angaben verwenden yyyy-MM-dd HH:mm:ss

Authentifizierung

Dieser Server verwendet die App-Passwort-Authentifizierung von TrackingTime. Ihr echtes Passwort wird niemals gespeichert. Das App-Passwort wird als HTTP Basic Auth (API_TOKEN:<app_password>) über SSL gesendet.

Wenn ein App-Passwort kompromittiert wurde, widerrufen Sie es in TrackingTime und erstellen Sie ein neues — Sie müssen Ihr Kontopasswort nicht ändern.

Lizenz

MIT

Related MCP Connectors

Related MCP Servers