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.

Requirements

Node.js 18 or higher — the server uses the native fetch global, which was introduced in Node 18. Running on an older version will exit immediately with a clear error message.

The included .nvmrc and bin/run.sh wrapper target Node 22, which is the recommended version for running this server.

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.

Parameter	Type	Required	Description
`startDate`	string	Yes	Monday of the week (YYYY-MM-DD)

`get_registrations_by_date_range`

Get time registrations between two dates.

Parameter	Type	Required	Description
`startDate`	string	Yes	Start date (YYYY-MM-DD)
`endDate`	string	Yes	End date (YYYY-MM-DD)

`get_financial_data`

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

Parameter	Type	Required	Description
`startDate`	string	Yes	Start date (YYYY-MM-DD)
`endDate`	string	Yes	End date (YYYY-MM-DD)

`search_tasks`

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

Parameter	Type	Required	Description
`searchText`	string	No	Task name or task number to search for
`searchAll`	boolean	No	Search all tasks, not just recent (default: false)

`create_time_registration`

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

Parameter	Type	Required	Description
`TaskID`	integer	Yes	Task identifier (from `search_tasks`)
`Date`	string	Yes	Date of the registration (YYYY-MM-DD)
`Hours`	number	Yes	Number of hours to register
`Comment`	string	No	Comment for the registration
`JiraId`	string	No	JIRA ticket ID (e.g. XXX-1234)
`Billable`	boolean	No	Whether this time is billable (defaults to task setting)

`update_time_registration`

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

Parameter	Type	Required	Description
`TimeRegistrationID`	integer	Yes	Time registration ID to update
`TaskID`	integer	Yes	Task identifier
`Date`	string	No	New date (YYYY-MM-DD)
`Hours`	number	No	New hours value
`Comment`	string	No	New comment
`JiraId`	string	No	JIRA ticket ID (e.g. SGI-82108)
`Billable`	boolean	No	Whether this time is billable

`delete_time_registration`

Delete a time registration by its GUID.

Parameter	Type	Required	Description
`id`	string (UUID)	Yes	GUID of the time registration to delete

Absence

`search_absence_codes`

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

Parameter	Type	Required	Description
`searchText`	string	No	Filter by absence code name or number

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

Parameter	Type	Required	Description
`AbsenceCodeID`	integer	Yes	Absence code identifier (from `search_absence_codes`)
`Date`	string	Yes	Date of the absence (YYYY-MM-DD)
`Hours`	number	No	Hours to register (omit for a full working day)
`Comment`	string	No	Comment for the registration

Timesheet Approval

`get_timesheet_status`

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

Parameter	Type	Required	Description
`startDate`	string	Yes	Start date (YYYY-MM-DD)
`endDate`	string	Yes	End date (YYYY-MM-DD)
`userId`	integer	No	Filter by employee UserID (omit for all employees)
`departmentId`	integer	No	Filter by department ID
`approverId`	integer	No	Filter by approver UserID
`legalEntityId`	integer	No	Filter by legal entity ID

`submit_timesheet`

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

Parameter	Type	Required	Description
`startDate`	string	Yes	Start date (YYYY-MM-DD)
`endDate`	string	Yes	End date (YYYY-MM-DD)
`comment`	string	No	Comment for the submission
`employeeUserId`	integer	No	UserID of the employee to submit for (defaults to authenticated user)

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

As a Claude Code plugin (recommended)

This repo doubles as a Claude Code plugin marketplace. Add it once, then install the plugin:

/plugin marketplace add Amoeslund/Timelog-MCP-server
/plugin install timelog@timelog-mcp

Claude Code will prompt for your Timelog Personal Access Token and API base URL during install and wire up the MCP server for you (it runs the published timelog-mcp package via npx). No manual .mcp.json editing required. See Configuration for how to obtain those values.

Via npx (manual)

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

The package includes a wrapper script (bin/run.sh) that sources nvm at startup and runs the server with the version declared in .nvmrc (Node 22). This means the correct Node version is selected on every run, regardless of what your shell's default is.

nvm users: MCP servers run as subprocesses and don't inherit nvm shell hooks, so your shell's active version doesn't apply. The wrapper handles this automatically. If you prefer to use npx directly without the wrapper, make sure your nvm default is Node 18+:
nvm alias default 22

From source

git clone git@github.com:Amoeslund/Timelog-MCP-server.git
cd Timelog-MCP-server
nvm use        # picks up .nvmrc (Node 22)
npm install
npm run build

Then point your MCP config at the wrapper script so the correct Node version is used on every launch:

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

Alternatively, if you want to call node directly, use an absolute path to a Node 18+ binary:

{
  "mcpServers": {
    "timelog": {
      "command": "/path/to/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

Variable	Required	Description
`TIMELOG_PAT`	Yes	Personal Access Token (see above)
`TIMELOG_BASE_URL`	Yes	API base URL (see above)

License

ISC

Name		Name	Last commit message	Last commit date
.claude-plugin		.claude-plugin
.github		.github
bin		bin
src		src
tests		tests
.gitignore		.gitignore
.npmrc		.npmrc
.nvmrc		.nvmrc
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Navigation Menu

Repository files navigation

Timelog MCP Server

Requirements

Capabilities

Tools

User & Organization

`get_current_user`

`get_legal_entities`

Time Registrations

`get_weekly_registrations`

`get_registrations_by_date_range`

`get_financial_data`

`search_tasks`

`create_time_registration`

`update_time_registration`

`delete_time_registration`

Absence

`search_absence_codes`

`create_absence_registration`

Timesheet Approval

`get_timesheet_status`

`submit_timesheet`

Manager Workflows

Finding and closing open timesheets

Setup

As a Claude Code plugin (recommended)

Via npx (manual)

From source

Configuration

Personal Access Token

Base URL

Environment Variables

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Timelog MCP Server

Requirements

Capabilities

Tools

User & Organization

get_current_user

get_legal_entities

Time Registrations

get_weekly_registrations

get_registrations_by_date_range

get_financial_data

search_tasks

create_time_registration

update_time_registration

delete_time_registration

Absence

search_absence_codes

create_absence_registration

Timesheet Approval

get_timesheet_status

submit_timesheet

Manager Workflows

Finding and closing open timesheets

Setup

As a Claude Code plugin (recommended)

Via npx (manual)

From source

Configuration

Personal Access Token

Base URL

Environment Variables

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

`get_current_user`

`get_legal_entities`

`get_weekly_registrations`

`get_registrations_by_date_range`

`get_financial_data`

`search_tasks`

`create_time_registration`

`update_time_registration`

`delete_time_registration`

`search_absence_codes`

`create_absence_registration`

`get_timesheet_status`

`submit_timesheet`