Skip to main content
Glama

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: Tripletex MCP Server

Tools

Benutzer & Organisation

get_current_user

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

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.

Parameter

Typ

Erforderlich

Beschreibung

startDate

string

Ja

Montag der Woche (JJJJ-MM-TT)

get_registrations_by_date_range

Ruft Zeiterfassungen zwischen zwei Daten ab.

Parameter

Typ

Erforderlich

Beschreibung

startDate

string

Ja

Startdatum (JJJJ-MM-TT)

endDate

string

Ja

Enddatum (JJJJ-MM-TT)

get_financial_data

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

Parameter

Typ

Erforderlich

Beschreibung

startDate

string

Ja

Startdatum (JJJJ-MM-TT)

endDate

string

Ja

Enddatum (JJJJ-MM-TT)

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.

Parameter

Typ

Erforderlich

Beschreibung

searchText

string

Nein

Aufgabenname oder Aufgabennummer, nach der gesucht werden soll

searchAll

boolean

Nein

Alle Aufgaben durchsuchen, nicht nur aktuelle (Standard: false)

create_time_registration

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

Parameter

Typ

Erforderlich

Beschreibung

TaskID

integer

Ja

Aufgabenkennung (aus search_tasks)

Date

string

Ja

Datum der Erfassung (JJJJ-MM-TT)

Hours

number

Ja

Anzahl der zu registrierenden Stunden

Comment

string

Nein

Kommentar zur Erfassung

JiraId

string

Nein

JIRA-Ticket-ID (z. B. XXX-1234)

Billable

boolean

Nein

Ob diese Zeit abrechenbar ist (Standard: Aufgabeneinstellung)

update_time_registration

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

Parameter

Typ

Erforderlich

Beschreibung

TimeRegistrationID

integer

Ja

ID der zu aktualisierenden Zeiterfassung

TaskID

integer

Ja

Aufgabenkennung

Date

string

Nein

Neues Datum (JJJJ-MM-TT)

Hours

number

Nein

Neuer Stundenwert

Comment

string

Nein

Neuer Kommentar

JiraId

string

Nein

JIRA-Ticket-ID (z. B. SGI-82108)

Billable

boolean

Nein

Ob diese Zeit abrechenbar ist

delete_time_registration

Löscht eine Zeiterfassung anhand ihrer GUID.

Parameter

Typ

Erforderlich

Beschreibung

id

string (UUID)

Ja

GUID der zu löschenden Zeiterfassung

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.

Parameter

Typ

Erforderlich

Beschreibung

searchText

string

Nein

Filter nach Abwesenheitscode-Name oder -Nummer

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.

Parameter

Typ

Erforderlich

Beschreibung

AbsenceCodeID

integer

Ja

Abwesenheitscode-Kennung (aus search_absence_codes)

Date

string

Ja

Datum der Abwesenheit (JJJJ-MM-TT)

Hours

number

Nein

Zu registrierende Stunden (weglassen für vollen Arbeitstag)

Comment

string

Nein

Kommentar zur Erfassung

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).

Parameter

Typ

Erforderlich

Beschreibung

startDate

string

Ja

Startdatum (JJJJ-MM-TT)

endDate

string

Ja

Enddatum (JJJJ-MM-TT)

userId

integer

Nein

Filter nach Mitarbeiter-UserID (weglassen für alle Mitarbeiter)

departmentId

integer

Nein

Filter nach Abteilungs-ID

approverId

integer

Nein

Filter nach Genehmiger-UserID

legalEntityId

integer

Nein

Filter nach Rechtseinheits-ID

submit_timesheet

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

Parameter

Typ

Erforderlich

Beschreibung

startDate

string

Ja

Startdatum (JJJJ-MM-TT)

endDate

string

Ja

Enddatum (JJJJ-MM-TT)

comment

string

Nein

Kommentar zur Einreichung

employeeUserId

integer

Nein

UserID des Mitarbeiters, für den eingereicht wird (Standard: authentifizierter Benutzer)

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

Variable

Erforderlich

Beschreibung

TIMELOG_PAT

Ja

Persönliches Zugriffstoken (siehe oben)

TIMELOG_BASE_URL

Ja

API-Basis-URL (siehe oben)

Lizenz

ISC

Available Tools

21 tools
create_absence_registrationA

Create an absence registration (e.g. vacation, sick leave). Use search_absence_codes to find the AbsenceCodeID. Registers a full day by default; specify Hours for partial days.

Inputs: Date (required), AbsenceCodeID (required), Hours, Comment.

create_taskB

Create a new task (phase) on a project. Use search_projects to find the ProjectID first.

Inputs: EndDate (required), TaskName (required), ProjectID (required), StartDate (required), +7 more.

create_time_registrationA

Create a new time registration on a task. Use search_tasks first to find the TaskID.

Inputs: Date (required), Hours (required), TaskID (required), JiraId, +2 more.

delete_time_registrationB

Delete a time registration by its GUID.

Inputs: id (required).

get_contract_hourly_ratesA

Get all hourly rates configured on a specific contract. Returns rate name (role), amount, currency, type, and active status. Use get_project_contracts first to find the contractId.

Inputs: contractId (required).

get_current_userA

Get the currently authenticated Timelog user (name, email, department).

Inputs: no named parameters.

get_financial_dataB

Get financial data (billable/invoice status) for time registrations in a date range.

Inputs: endDate (required), startDate (required).

get_fixed_price_contract_detailsA

Get complete details for a fixed-price contract: contract value (from payment plan), payment schedule, linked fixed-price tasks/phases, and configured hourly rates. The contract value is the total price agreed with the client. For FP contracts, hourly rates are typically 0 (billing isn't per-hour) — use the overall project financial data to compute effective rates.

Inputs: projectId (required), contractId (required).

get_hourly_ratesA

Get hourly rates defined in Timelog. Returns rate name, amount, currency, customer, and active status. Use searchText to filter by name. Results are paginated.

Inputs: pageSize, pageNumber, searchText.

get_projectA

Get project details by project ID. Returns name, project number, customer, project manager, budget, dates, and type.

Inputs: projectId (required).

get_project_contractsA

Get all contracts for a project. Returns contract ID, name, type (Fixed Price / Time & Material), status, and whether it's the main contract. Use the contractId with get_contract_hourly_rates to see rates.

Inputs: projectId (required).

get_project_tasksA

Get all tasks (phases) for a project. Returns task IDs, names, parent hierarchy, fixed-price status, and billable defaults. Use the projectId from get_project or from time registrations.

Inputs: projectId (required), pageSize, pageNumber.

get_registrations_by_date_rangeB

Get time registrations between two dates.

Inputs: endDate (required), startDate (required).

get_timesheet_statusB

Get weekly timesheet status. Defaults to the authenticated user. Pass userId to check a specific employee, or omit to get all employees (manager view). Can also filter by departmentId, approverId, or legalEntityId.

Inputs: endDate (required), startDate (required), userId, approverId, +2 more.

get_weekly_registrationsA

Get time registrations for a specific week. Provide the Monday date of the week.

Inputs: startDate (required).

search_absence_codesA

Search for absence codes (e.g. Ferie, Sygdom). Returns AbsenceCodeID needed for create_absence_registration.

Inputs: searchText.

search_projectsA

Search for projects by name or number. Returns project IDs, names, numbers, and customer info.

Inputs: searchText.

search_tasksA

Search for tasks the user can register time on. Returns task IDs needed for creating time registrations. Use searchText to filter by task or project name.

Inputs: searchAll, searchText.

submit_timesheetB

Submit timesheet for approval for a date range (e.g. a full week).

Inputs: endDate (required), startDate (required), comment, employeeUserId.

update_time_registrationA

Update an existing time registration (hours, comment, date, billable status).

Inputs: TaskID (required), TimeRegistrationID (required), Date, Hours, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools target distinct resources (time registrations, absence, projects, contracts, rates), but there is potential overlap between get_weekly_registrations and get_registrations_by_date_range, and between get_hourly_rates and get_contract_hourly_rates. Descriptions clarify the differences, so only minor confusion risk exists.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern (e.g., get_project, create_time_registration, search_tasks, update_time_registration, submit_timesheet). The naming convention is uniform and predictable, with no mixed styles or vague verbs.

    Tool Count4/5

    21 tools is on the higher end but appropriate for a comprehensive time tracking and project management domain. The server covers time registration, absence, projects, contracts, rates, financials, and users, so the tool count is justified without being bloated.

    Completeness4/5

    The tool surface covers core CRUD for time registrations, timesheet submission and status, project and task search, contract and rate queries, and financial data. Minor gaps exist, such as lack of update/delete for absence registrations and no direct query for absence registrations, but these are workable.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers