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

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