Track Your Time

本地服务

trackyourtime.dev生产力32 周前更新

代码仓库访问官网

关于 Track Your Time

Track Your Time MCP 服务让用户通过 MCP 客户端管理计时器、工时记录、目录条目并汇总工时。它可连接托管服务或自托管实例，提供的工具由 API 令牌的权限范围决定。

主要功能

01启动和停止计时器
02记录和列出工时条目
03管理客户、项目、任务和标签
04生成汇总报告
05按令牌权限限制工具

适用场景

01通过 MCP 客户端启动计时器
02补记遗漏的工时
03查看工作区的工时记录
04汇总已跟踪的工时

MCP 相关

该 MCP 服务按令牌权限向 MCP 客户端提供时间跟踪、目录和报告工具。它通过 stdio 运行，并调用托管或自托管服务的 REST API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "trebeljahr-trackyourtime": {
      "command": "npx",
      "args": [
        "-y",
        "trackyourtime-mcp"
      ],
      "env": {
        "TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>",
        "TRACKYOURTIME_API_URL": "<TRACKYOURTIME_API_URL>"
      }
    }
  }
}

启动命令npx -y trackyourtime-mcp

需要配置的环境变量

TRACKYOURTIME_API_TOKEN密钥A workspace API token created in Settings → Integrations.

TRACKYOURTIME_API_URLAPI origin. Defaults to https://api.trackyourtime.dev; use your own instance's origin for self-hosting.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmtrackyourtime-mcp0.3.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Track Your Time MCP 服务

从 MCP 客户端启动计时器、补录遗漏的工时，或请求报告。使用托管的 Track Your Time 服务或自己的服务。

需要 Node.js 24 或更高版本，以及 Track Your Time API 令牌。

连接

在 Settings → Integrations → API tokens 中创建令牌。只选择所需的权限范围。令牌属于一个工作区。

将此条目添加到 MCP 客户端的配置中：

{
  "mcpServers": {
    "trackyourtime": {
      "command": "npx",
      "args": ["-y", "trackyourtime-mcp"],
      "env": {
        "TRACKYOURTIME_API_TOKEN": "tt_your_token"
      }
    }
  }
}

如果自行托管，还要将 TRACKYOURTIME_API_URL 设置为实例的源站地址，例如 https://time.example.com。

请将 API 令牌视同密码。MCP 客户端的配置文件通常会以纯文本形式存储令牌。停止使用时，请在 Track Your Time 中撤销令牌。

可用工具

服务会读取令牌的权限范围，并提供这些权限允许使用的工具：

权限范围	工具
无	`get_token_info`
`entries:read`	`get_running_timer`、`list_entries`
`entries:write`	`start_timer`、`stop_timer`、`log_time_entry`
`catalog:read`	`list_clients`、`list_projects`、`list_tasks`、`list_tags`
`catalog:write`	`create_client`、`create_project`、`create_task`、`create_tag`
`reports:read`	`summary_report`