AI导哈

时间追踪API工具

Clockify MCP Server是一个提供与Clockify时间追踪API交互工具的服务，支持工作区管理、项目管理和时间报告生成。

  • by Yikizi
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Yikizi/clockify-mcp-server

使用说明

时钟化MCP服务器

一种MCP（模型上下文协议）服务器，提供与Clockify时间跟踪API交互的工具。

安装

npm install -g @yikizi/clockify-mcp

或者直接与npx一起使用：

npx @yikizi/clockify-mcp

特性

  • 工作空间管理：列出工作区、获取当前用户、列出工作区用户
  • 项目管理：列出/创建项目，列出/创建任务
  • 时间跟踪：启动/停止计时器、记录时间条目、更新/删除条目
  • 报告：通过分组和筛选生成摘要和详细报告
  • 标签和客户：列出并创建标签，列出客户端

设置

1.获取Clockify API密钥

  1. 首选 时钟化用户设置
  2. 滚动至“API”部分
  3. 单击“生成”创建API密钥

2.配置克劳德代码

添加到您的Claude Code MCP设置中(~/.claude.json 或通过克劳德代码设置）：

选项A:CLI参数（推荐）

{
  "mcpServers": {
    "clockify": {
      "command": "npx",
      "args": ["@yikizi/clockify-mcp", "--api-key", "your-api-key-here"]
    }
  }
}

选项B：环境变量

{
  "mcpServers": {
    "clockify": {
      "command": "npx",
      "args": ["@yikizi/clockify-mcp"],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}

选项C:.env文件

创建 .env 工作目录中的文件：

CLOCKIFY_API_KEY=your-api-key-here

可用工具

便利工具（推荐）

这些自动检测您的用户和工作区：

  • start_timer -启动计时器（只需提供描述和可选项目）
  • stop_current_timer -停止正在运行的计时器
  • get_running_timer -检查计时器是否正在运行，并查看经过的时间
  • log_time -以人类可读的持续时间记录完成时间（“1h30m”、“2h”、“45m”）

工作区工具

  • get_workspaces -列出所有工作区
  • get_current_user -获取经过身份验证的用户信息
  • get_workspace_users -列出工作区中的用户

项目工具

  • get_projects -列出项目（带存档过滤器）
  • create_project -创建新项目
  • get_project_tasks -列出项目中的任务
  • create_task -创建任务

时间输入工具（低级）

  • get_time_entries -获取用户的时间条目（使用日期/项目筛选器）
  • create_time_entry -创建时间条目（使用 start_timer 或 log_time 相反）
  • stop_timer -特定用户的停止计时器（使用 stop_current_timer 相反）
  • update_time_entry -更新现有条目
  • delete_time_entry -删除时间条目

报告工具

  • get_summary_report -按项目/用户/客户分组的汇总报告
  • get_detailed_report -带过滤器的时间条目的详细列表

标签和客户端工具

  • get_tags -列出所有标签
  • create_tag -创建新标签
  • get_clients -列出所有客户

使用示例

配置后，您可以向Claude询问以下问题：

  • “启动用于处理API项目的计时器”
  • “停止我的计时器”
  • “记录2小时的文档工作”
  • “我的计时器在运行吗？”
  • “生成上周的摘要报告”
  • “这个月我记录了多少时间？”
  • “列出我的所有项目”

更新日志

v1.2.2

  • 配置：API密钥现在可以通过 --api-key CLI参数
  • 配置：API密钥可以从 .env 当前目录中的文件
  • 改进：显示所有配置选项的更好的错误消息

v1.2.1

  • 错误修复: get_running_timer 现在可以正确找到正在运行的计时器（只检查了1个条目）
  • 错误修复: stop_current_timer 现在正确停止计时器
  • 改进: stop_current_timer 接受可选 end 倒计时时间

v1.2.0版本

  • 响应中人类可读的持续时间(1h 30m 而不是 PT1H30M)
  • 相对周期过滤器 get_time_entries: today, yesterday, this_week, last_week, this_month, last_month
  • get_time_entries 现在默认为当前用户/工作区（不需要ID！）
  • 响应包括所有条目的总时间

v1.1.0版本

  • 增加了便利工具： start_timer, stop_current_timer, get_running_timer, log_time
  • 自动检测用户和工作区（无需调用 get_current_user 第一）
  • 人类可读的持续时间格式（“1h30m”） log_time
  • 输入验证以尽早发现日期拼写错误
  • 启动新计时器时，如果计时器已在运行，则发出警告

v1.0.0

  • 带有核心Clockify API支持的首次发布

许可证

麻省理工学院

相关 MCP