Timelog MCP Server

Ein MCP-Server, der die Timelog-Zeiterfassungs-API als Tools für Claude bereitstellt. Sie können damit Zeiterfassungen, Abwesenheiten und Stundenzettelgenehmigungen über natürliche Sprache anzeigen, erstellen und verwalten.

Funktionen

• Zeiterfassungen anzeigen – nach Woche oder beliebigem Datumsbereich, einschließlich finanzieller/abrechenbarer Daten

• Zeiterfassungen erstellen, aktualisieren und löschen – für jede Aufgabe, auf die Sie Zugriff haben

• Abwesenheitsverwaltung – Abwesenheitscodes suchen und Urlaub, Krankheit usw. registrieren

• Stundenzettelgenehmigung – Einreichungsstatus prüfen und Stundenzettel einreichen, mit Filter nach Mitarbeiter, Abteilung, Genehmiger oder Rechtseinheit

• Organisation – Rechtseinheiten und das aktuelle Benutzerprofil nachschlagen

• Aufgabensuche – Aufgaben zum Registrieren von Zeit nach Name oder Nummer finden

Related MCP server: TimeChimp MCP Server

Tools

Benutzer & Organisation

get_current_user

Ruft das Profil des authentifizierten Benutzers ab (Name, E-Mail, Abteilung). Keine Parameter.

get_legal_entities

Ruft alle Rechtseinheiten in der Organisation ab. Gibt ID, Name, Aktivstatus, Währung und Land für jede Einheit zurück. Keine Parameter.

Zeiterfassungen

get_weekly_registrations

Ruft Zeiterfassungen für eine bestimmte Woche ab, gruppiert nach Tag mit Normstunden.

get_registrations_by_date_range

Ruft Zeiterfassungen zwischen zwei Daten ab.

get_financial_data

Ruft finanzielle Daten (abrechenbar/Rechnungsstatus) für Zeiterfassungen in einem Datumsbereich ab.

search_tasks

Sucht nach Aufgaben, auf denen der Benutzer Zeit registrieren kann. Gibt Aufgaben-IDs zurück, die zum Erstellen von Zeiterfassungen benötigt werden.

create_time_registration

Erstellt eine neue Zeiterfassung auf einer Aufgabe. Verwenden Sie zuerst search_tasks, um die TaskID zu finden.

update_time_registration

Aktualisiert eine vorhandene Zeiterfassung. Geben Sie nur die Felder an, die Sie ändern möchten.

delete_time_registration

Löscht eine Zeiterfassung anhand ihrer GUID.

Abwesenheit

search_absence_codes

Sucht nach Abwesenheitscodes (z. B. Ferie, Sygdom). Gibt die AbsenceCodeID zurück, die für create_absence_registration benötigt wird.

create_absence_registration

Erstellt eine Abwesenheitserfassung (Urlaub, Krankheit usw.). Verwenden Sie search_absence_codes, um die AbsenceCodeID zu finden. Registriert standardmäßig einen vollen Arbeitstag.

Stundenzettelgenehmigung

get_timesheet_status

Ruft den wöchentlichen Genehmigungs-/Einreichungsstatus von Stundenzetteln ab. Standardmäßig für den authentifizierten Benutzer. Lassen Sie userId weg, um alle Mitarbeiter zu erhalten (Manager-Ansicht).

submit_timesheet

Reicht einen Stundenzettel zur Genehmigung für einen Datumsbereich ein (z. B. eine ganze Woche).

Manager-Workflows

Offene Stundenzettel finden und schließen

Verwenden Sie get_timesheet_status ohne userId, um den Einreichungsstatus für alle Mitarbeiter in einem Zeitraum zu erhalten. Filtern Sie nach departmentId, approverId oder legalEntityId, um den Umfang einzugrenzen.

Sobald Sie Mitarbeiter mit offenen Stundenzetteln identifiziert haben, verwenden Sie submit_timesheet mit employeeUserId, um in deren Namen einzureichen.

Beispielaufforderungen:

„Zeig mir alle, die diese Woche ihren Stundenzettel nicht eingereicht haben" „Reiche den Stundenzettel dieser Woche für Benutzer 1234 ein" „Reiche alle offenen Stundenzettel für Abteilung 5 diese Woche ein"

Einrichtung

Über npx (empfohlen)

Fügen Sie zu Ihrer Claude Code .mcp.json oder Claude Desktop-Konfiguration hinzu:

{
  "mcpServers": {
    "timelog": {
      "command": "npx",
      "args": ["-y", "timelog-mcp"],
      "env": {
        "TIMELOG_PAT": "<your-personal-access-token>",
        "TIMELOG_BASE_URL": "https://app[X].timelog.com/<your-account>/api"
      }
    }
  }
}

Aus dem Quellcode

git clone git@github.com:Amoeslund/Timelog-MCP-server.git
cd Timelog-MCP-server
npm install
npm run build

Dann verweisen Sie Ihre MCP-Konfiguration auf die erstellte Datei:

{
  "mcpServers": {
    "timelog": {
      "command": "node",
      "args": ["/path/to/Timelog-MCP-server/dist/index.js"],
      "env": {
        "TIMELOG_PAT": "<your-personal-access-token>",
        "TIMELOG_BASE_URL": "https://app[X].timelog.com/<your-account>/api"
      }
    }
  }
}

Konfiguration

Persönliches Zugriffstoken

Generieren Sie ein PAT unter https://login.timelog.com/personaltoken.

Basis-URL

Ihre URL folgt dem Muster https://app[X].timelog.com/<your-account>/api, wobei [X] eine Servernummer (1–10) und <your-account> Ihr Timelog-Kontoname ist. Weitere Details finden Sie in der Timelog-API-Dokumentation.

Umgebungsvariablen

Lizenz

ISC