Timelog MCP Server

时间日志MCP服务器

一 主控程序 暴露的服务器 时间表 时间注册API作为Claude的工具。它允许您通过自然语言查看、创建和管理时间登记、缺勤和时间表审批。

能力

• 查看时间注册 --按周或任意日期范围，包括财务/计费数据
• 创建、更新和删除 您有权访问的任何任务的时间注册
• 缺勤管理 --搜索缺勤代码并登记假期、病假等。
• 时间表审批 --检查提交状态并提交时间表，按员工、部门、审批人或法人实体进行筛选
• 组织 --查找法人实体和当前用户资料
• 任务搜索 --按名称或编号查找要注册时间的任务

工具

用户和组织

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）。返回所需的缺勤代码ID create_absence_registration.

create_absence_registration

创建缺勤登记（休假、病假等）。使用 search_absence_codes 查找缺席代码ID。默认情况下注册一个完整的工作日。

时间表审批

get_timesheet_status

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

submit_timesheet

提交一份日期范围（例如一整周）的时间表以供审批。

经理工作流

查找并关闭开放时间表

使用 get_timesheet_status 没有a userId 获取一段时间内所有员工的提交状态。筛选依据 departmentId, approverId，或 legalEntityId 缩小范围。

一旦您确定了有开放时间表的员工，请使用 submit_timesheet 随着 employeeUserId 代表他们提交。

示例提示：

“显示本周未提交时间表的所有人” “提交用户1234的本周时间表” “本周提交第5部门的所有开放时间表”

设置

通过npx（推荐）

添加到您的克劳德代码 .mcp.json 或Claude桌面配置：

{
  "mcpServers": {
    "timelog": {
      "command": "npx",
      "args": ["-y", "timelog-mcp"],
      "env": {
        "TIMELOG_PAT": "",
        "TIMELOG_BASE_URL": "https://app[X].timelog.com//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": "",
        "TIMELOG_BASE_URL": "https://app[X].timelog.com//api"
      }
    }
  }
}

配置

个人访问令牌

生成PAThttps://login.timelog.com/personaltoken.

基础URL

您的URL遵循以下模式 https://app[X].timelog.com//api 哪里 [X] 是一个服务器号（1-10），以及 `` 是您的Timelog帐户名。看 API时间日志文档 了解详情。

环境变量

许可证

ISC