Skip to main content
Glama
deenesjakoruzh
ficus33

TrackingTime MCP Server

by ficus33
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

TrackingTime MCP 服务器

一个将 Claude 等 AI 助手连接到 TrackingTime API v4 的 MCP (Model Context Protocol) 服务器。通过自然语言管理项目、任务、时间跟踪、员工分配和客户。

快速入门

1. 获取您的 TrackingTime 凭据

  • 应用密码 (App Password): TrackingTime → 管理 (Manage) → 用户设置 (User Settings) → 应用与集成 (Apps & Integrations) → 创建新的应用密码

  • 账户 ID (Account ID): 登录后在您的 TrackingTime URL 中可见，或在账户设置中查看

2. 添加到您的 AI 助手

Claude Code:

claude mcp add trackingtime -e TT_APP_PASSWORD=your-app-password -e TT_ACCOUNT_ID=your-account-id -- npx trackingtime-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "trackingtime": {
      "command": "npx",
      "args": ["trackingtime-mcp"],
      "env": {
        "TT_APP_PASSWORD": "your-app-password",
        "TT_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

添加后请重启您的助手。

替代方案：从源码安装

如果您更喜欢克隆并在本地构建：

git clone https://github.com/ficus33/trackingtime-mcp.git
cd trackingtime-mcp
npm install
npm run build
cp .env.example .env   # then edit .env with your credentials

然后将您的助手指向本地构建版本：

claude mcp add trackingtime -- node /path/to/trackingtime-mcp/dist/index.js

Related MCP server: Clockify MCP Server

工具

项目

工具

描述

tt_list_projects

列出项目 (过滤器: ACTIVE/ARCHIVED/ALL/FOLLOWING)

tt_list_project_ids

仅列出项目 ID (轻量级，用于批量操作)

tt_search_projects

按关键字搜索项目和任务

tt_create_project

创建新项目

tt_update_project

编辑项目名称、客户或服务

tt_update_project_preferences

设置收藏、默认视图、显示已关闭任务

tt_get_project

获取带有详细标志的单个项目

tt_get_project_times

获取多个项目的累计时间

tt_get_project_users

查看哪些员工参与了项目

tt_archive_project

归档项目 (可撤销)

tt_reopen_project

重新打开已归档的项目

tt_delete_project

永久删除项目

tt_merge_projects

将一个项目合并到另一个项目中

任务

工具

描述

tt_list_tasks

列出任务 (过滤器: ACTIVE/ARCHIVED/ALL/TRACKING)

tt_create_task

创建带有受让人、截止日期、预估时间的任务

tt_update_task

编辑任务或重新分配员工

tt_get_task

获取单个任务详情

tt_get_task_times

获取多个任务的累计时间

tt_search_tasks

在项目内按名称搜索任务

tt_sort_tasks

按排序索引重新排列任务

tt_import_tasks

批量导入任务（带预览模式）

tt_close_task

将任务标记为完成

tt_reopen_task

重新打开已完成的任务

tt_delete_task

删除任务

时间跟踪

工具

描述

tt_start_timer

在任务上启动计时器

tt_stop_timer

停止正在运行的计时器

时间条目

工具

描述

tt_list_time_entries

按用户/项目/客户/任务 + 日期范围列出条目

tt_list_time_entries_min

轻量级最小列表 (计费过滤器，休假)

tt_count_time_entries

快速统计过滤后的条目数量

tt_add_time_entry

添加手动时间条目 (持续时间以秒为单位)

tt_get_time_entry

获取单个时间条目

tt_update_time_entry

编辑时间条目

tt_delete_time_entry

删除时间条目

tt_get_events_summary

每个用户每天的工时汇总

tt_export_time_entries

导出为 CSV

tt_mark_billed

将条目标记为已计费

tt_mark_not_billed

取消标记已计费条目

事件标签

工具

描述

tt_list_tags

列出所有标签定义

tt_get_tag

获取单个标签

tt_list_tag_values

列出标签名称所使用的值

tt_create_tag

创建标签定义

tt_update_tag

更新标签

tt_delete_tag

删除标签定义

tt_save_event_tag

在时间条目上附加/更新标签

tt_delete_event_tag

从时间条目中移除标签

用户与员工

工具

描述

tt_list_users

列出所有员工 (查找用户 ID)

tt_get_user

获取单个用户详情

tt_create_user

创建用户 (替换已移除的 tt_invite_users)

tt_update_user

更新用户资料

tt_update_user_permissions

设置细粒度的编辑/查看权限

tt_update_employee

更新人力资源字段 (职位、部门、日期等)

tt_resend_invite

向待处理用户重新发送激活邮件

tt_reset_icalendar_token

轮换用户的 iCal 导出令牌

tt_get_user_tasks

列出用户按项目分组的任务

tt_get_user_tracking

查看用户当前正在跟踪的内容

tt_get_user_trackables

分配给用户的所有项目和任务

tt_get_user_projects

列出分配给用户的项目

tt_assign_user_projects

将员工分配到项目

tt_remove_user_projects

从项目中移除员工

tt_archive_user

停用用户 (仅限管理员)

tt_reactivate_user

重新激活已归档的用户

用户组

工具

描述

tt_list_user_groups

列出组 (过滤器: ACTIVE/ARCHIVED/ALL)

tt_get_user_group

获取单个组

tt_create_user_group

创建组 (需要主管 + 成员)

tt_update_user_group

更新组 (通过 status: "ARCHIVED" 归档)

tt_delete_user_group

永久删除组

客户

工具

描述

tt_list_customers

列出客户 (过滤器: ACTIVE/ARCHIVED/ALL)

tt_get_customer

获取单个客户详情

tt_create_customer

创建新客户

tt_update_customer

编辑客户详情

tt_delete_customer

永久删除客户

tt_archive_customer

归档客户 (可撤销)

tt_reactivate_customer

重新激活已归档的客户

服务

工具

描述

tt_list_services

列出服务 (工作类别)

tt_get_service

获取服务

tt_create_service

创建新服务

tt_update_service

更新服务

tt_archive_service

归档服务 (可撤销)

tt_reactivate_service

重新激活已归档的服务

tt_delete_service

永久删除服务

团队 (工作区)

工具

描述

tt_list_teams

列出用户所属的所有工作区

tt_switch_team

切换会话的活动工作区

tt_update_team_permissions

更新默认成员权限

报告

工具

描述

tt_get_user_report

包含图表和细分的每用户分析报告

通知

工具

描述

tt_list_notifications

列出通知 (USER 或 PROJECT 范围)

tt_mark_notification_read

将一条通知标记为已读

tt_mark_notifications_read

将多条通知标记为已读

Webhooks

工具

描述

tt_list_webhooks

列出已配置的 Webhooks

tt_get_webhook

获取 Webhook

tt_enable_webhook

启用 Webhook

tt_disable_webhook

禁用 Webhook

tt_reset_webhook_token

轮换 Webhook 的签名令牌

tt_delete_webhook

删除 Webhook

减少工具数量

所有 93 个工具默认处于活动状态。如果您发现这为您的 AI 助手增加了过多的上下文，您可以克隆仓库，在 src/tools.ts 中使用 /* */ 注释掉不需要的工具，然后运行 npm run build 来创建更精简的构建版本。

测试

使用 MCP Inspector 交互式测试工具：

npx @modelcontextprotocol/inspector npx trackingtime-mcp

API 注意事项

需要注意的一些 TrackingTime API 特性：

  • duration 和 accumulated_time 以秒为单位

  • estimated_time 和 worked_hours 以小时为单位

  • 时间条目在 API 中称为 "events"

  • 当计时器已经在运行时启动新计时器会返回 502 错误 — 请使用 stop_running_task=true 自动停止当前计时器

  • 日期使用 YYYY-MM-DD，日期时间使用 yyyy-MM-dd HH:mm:ss

身份验证

此服务器使用 TrackingTime 的应用密码身份验证。您的真实密码永远不会被存储。应用密码通过 SSL 以 HTTP 基本认证 (API_TOKEN:<app_password>) 的形式发送。

如果应用密码泄露，请在 TrackingTime 中撤销它并创建一个新的 — 无需更改您的账户密码。

许可证

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers