Timelog MCP 服务器

一个 MCP 服务器，将 Timelog 时间登记 API 以工具的形式暴露给 Claude。你可以通过自然语言查看、创建和管理时间登记、缺勤和工时表审批。

功能

• 查看时间登记 — 按周或任意日期范围查看，包括财务/可计费数据

• 创建、更新和删除 你有权限访问的任何任务上的时间登记

• 缺勤管理 — 搜索缺勤代码并登记假期、病假等

• 工时表审批 — 检查提交状态并提交工时表，可按员工、部门、审批人或法人实体筛选

• 组织 — 查询法人实体和当前用户资料

• 任务搜索 — 按名称或编号查找要登记时间的任务

Related MCP server: TimeChimp MCP Server

工具

用户与组织

get_current_user

获取已认证用户的资料（姓名、邮箱、部门）。无参数。

get_legal_entities

获取组织中的所有法人实体。返回每个实体的 ID、名称、启用状态、货币和国家。无参数。

时间登记

get_weekly_registrations

获取特定周的时间登记，按天分组并显示标准工时。

get_registrations_by_date_range

获取两个日期之间的时间登记。

get_financial_data

获取日期范围内时间登记的财务数据（可计费/发票状态）。

search_tasks

搜索用户可以登记时间的任务。返回创建时间登记所需的任务 ID。

create_time_registration

在任务上创建新的时间登记。请先使用 search_tasks 查找 TaskID。

update_time_registration

更新现有的时间登记。只需提供要更改的字段。

delete_time_registration

按 GUID 删除时间登记。

缺勤

search_absence_codes

搜索缺勤代码（例如 Ferie、Sygdom）。返回 create_absence_registration 所需的 AbsenceCodeID。

create_absence_registration

创建缺勤登记（假期、病假等）。请使用 search_absence_codes 查找 AbsenceCodeID。默认登记一个完整工作日。

工时表审批

get_timesheet_status

获取每周工时表审批/提交状态。默认为已认证用户。省略 userId 可获取所有员工（经理视图）。

submit_timesheet

为某个日期范围（例如一整周）提交工时表以供审批。

经理工作流

查找并关闭未提交的工时表

使用不带 userId 的 get_timesheet_status 获取某个时间段内所有员工的提交状态。通过 departmentId、approverId 或 legalEntityId 筛选以缩小范围。

确定有未提交工时表的员工后，使用带 employeeUserId 的 submit_timesheet 代其提交。

示例提示：

"显示本周所有未提交工时表的人" "为用户 1234 提交本周工时表" "提交部门 5 本周所有未提交的工时表"

设置

通过 npx（推荐）

添加到你的 Claude Code .mcp.json 或 Claude Desktop 配置中：

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

从源码构建

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

然后将你的 MCP 配置指向构建后的文件：

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

配置

个人访问令牌

在 https://login.timelog.com/personaltoken 生成 PAT。

基础 URL

你的 URL 遵循 https://app[X].timelog.com/<your-account>/api 模式，其中 [X] 是服务器编号（1–10），<your-account> 是你的 Timelog 账户名称。详见 Timelog API 文档。

环境变量

许可证

ISC