Timelog MCP Server

An MCP server that exposes the Timelog time registration API as tools for Claude. It lets you view, create, and manage time registrations, absences, and timesheet approvals through natural language.

Capabilities

• View time registrations — by week or arbitrary date range, including financial/billable data
• Create, update, and delete time registrations on any task you have access to
• Absence management — search absence codes and register vacation, sick leave, etc.
• Timesheet approval — check submission status and submit timesheets, with filtering by employee, department, approver, or legal entity
• Organization — look up legal entities and the current user profile
• Task search — find tasks to register time on by name or number

Tools

User & Organization

get_current_user

Get the authenticated user's profile (name, email, department). No parameters.

get_legal_entities

Get all legal entities in the organization. Returns ID, name, active status, currency, and country for each entity. No parameters.

Time Registrations

get_weekly_registrations

Get time registrations for a specific week, grouped by day with norm hours.

get_registrations_by_date_range

Get time registrations between two dates.

get_financial_data

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

search_tasks

Search for tasks the user can register time on. Returns task IDs needed for creating time registrations.

create_time_registration

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

update_time_registration

Update an existing time registration. Only supply the fields you want to change.

delete_time_registration

Delete a time registration by its GUID.

Absence

search_absence_codes

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

create_absence_registration

Create an absence registration (vacation, sick leave, etc.). Use search_absence_codes to find the AbsenceCodeID. Registers a full working day by default.

Timesheet Approval

get_timesheet_status

Get weekly timesheet approval/submission status. Defaults to the authenticated user. Omit userId to get all employees (manager view).

submit_timesheet

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

Manager Workflows

Finding and closing open timesheets

Use get_timesheet_status without a userId to get the submission status for all employees in a period. Filter by departmentId, approverId, or legalEntityId to narrow the scope.

Once you've identified employees with open timesheets, use submit_timesheet with employeeUserId to submit on their behalf.

Example prompts:

"Show me everyone who hasn't submitted their timesheet this week" "Submit this week's timesheet for user 1234" "Submit all open timesheets for department 5 this week"

Setup

Via npx (recommended)

Add to your Claude Code .mcp.json or Claude Desktop config:

{
  "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"
      }
    }
  }
}

From source

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

Then point your MCP config at the built file:

{
  "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"
      }
    }
  }
}

Configuration

Personal Access Token

Generate a PAT at https://login.timelog.com/personaltoken.

Base URL

Your URL follows the pattern https://app[X].timelog.com/<your-account>/api where [X] is a server number (1–10) and <your-account> is your Timelog account name. See the Timelog API docs for details.

Environment Variables

License

ISC