Timelog MCP Server
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.
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.
Parameter | Typ | Erforderlich | Beschreibung |
| string | Ja | Montag der Woche (JJJJ-MM-TT) |
get_registrations_by_date_range
Ruft Zeiterfassungen zwischen zwei Daten ab.
Parameter | Typ | Erforderlich | Beschreibung |
| string | Ja | Startdatum (JJJJ-MM-TT) |
| 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 |
| string | Ja | Startdatum (JJJJ-MM-TT) |
| 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 |
| string | Nein | Aufgabenname oder Aufgabennummer, nach der gesucht werden soll |
| 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 |
| integer | Ja | Aufgabenkennung (aus |
| string | Ja | Datum der Erfassung (JJJJ-MM-TT) |
| number | Ja | Anzahl der zu registrierenden Stunden |
| string | Nein | Kommentar zur Erfassung |
| string | Nein | JIRA-Ticket-ID (z. B. XXX-1234) |
| 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 |
| integer | Ja | ID der zu aktualisierenden Zeiterfassung |
| integer | Ja | Aufgabenkennung |
| string | Nein | Neues Datum (JJJJ-MM-TT) |
| number | Nein | Neuer Stundenwert |
| string | Nein | Neuer Kommentar |
| string | Nein | JIRA-Ticket-ID (z. B. SGI-82108) |
| boolean | Nein | Ob diese Zeit abrechenbar ist |
delete_time_registration
Löscht eine Zeiterfassung anhand ihrer GUID.
Parameter | Typ | Erforderlich | Beschreibung |
| 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 |
| 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 |
| integer | Ja | Abwesenheitscode-Kennung (aus |
| string | Ja | Datum der Abwesenheit (JJJJ-MM-TT) |
| number | Nein | Zu registrierende Stunden (weglassen für vollen Arbeitstag) |
| 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 |
| string | Ja | Startdatum (JJJJ-MM-TT) |
| string | Ja | Enddatum (JJJJ-MM-TT) |
| integer | Nein | Filter nach Mitarbeiter-UserID (weglassen für alle Mitarbeiter) |
| integer | Nein | Filter nach Abteilungs-ID |
| integer | Nein | Filter nach Genehmiger-UserID |
| 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 |
| string | Ja | Startdatum (JJJJ-MM-TT) |
| string | Ja | Enddatum (JJJJ-MM-TT) |
| string | Nein | Kommentar zur Einreichung |
| 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 buildDann 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 |
| Ja | Persönliches Zugriffstoken (siehe oben) |
| Ja | API-Basis-URL (siehe oben) |
Lizenz
ISC
Available Tools
21 toolscreate_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_legal_entitiesA
Get all legal entities in the Timelog organization. Returns ID, name, active status, currency, and country for each entity.
Inputs: no named parameters.
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
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Time tracking you talk to: log, check and fix your work hours from your AI assistant.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Read hours, absences and projects; start timers, add entries, approve leave in TimeTac.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables automated timesheet management including creating entries, listing work activities, managing daily scrum updates, and viewing assigned projects with automatic authentication handling.MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with the Tripletex accounting API to manage time tracking, projects, and timesheet approvals through natural language. It also supports searching and managing outgoing invoices and processing supplier invoice approvals.312ISC

Timesheet MCP Serverofficial
AlicenseBqualityBmaintenanceEnables natural language control of the Timesheet API for timer management, task tracking, and project management through MCP tools.50528 npm1MIT- FlicenseNot gradedqualityCmaintenanceEnables natural-language reading, logging, editing, and deleting of your own HaloPSA timesheet entries, scoped to timesheets only.-