<a href="https://glama.ai/mcp/servers/@inakianduaga/clockify-mcp"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=2162560888,3638888709&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Clockify MCP服务器" /> </a>

Clockify MCP服务器

此MCP服务器允许LLMs（如Cursor或Claude）与您的Clockify工作区进行交互，从而实现高级的时间跟踪自动化和报告。使用此服务器，您可以：

• 列出工作区中的所有项目
• 列出工作区中的所有用户
• 添加和查询时间条目（为自己或其他用户，如果具有权限）
• 拉取任何用户的工时表（跨所有项目）
• 使用Clockify汇总报告API生成按用户和项目划分的月度或自定义日期范围的工作小时数细分
• 与LLMs集成以自动化、总结或分析您的时间跟踪数据

<p align="center"> <img src="assets/clockify_example.png" alt="Clockify示例" width="600" /> </p>

功能

• listProjects: 列出已认证用户的所有项目
• getTimeEntries: 列出已认证用户的时间条目（可选日期过滤器）
• addTimeEntry: 向项目添加时间条目
• listUsers: 列出工作区中的所有用户
• getUserTimeEntries: 列出任何用户的时间条目（可选日期过滤器）
• getSummaryReport: 获取指定日期范围内按用户/项目划分的工作小时数汇总报告（可选用户ID/项目ID过滤）。支持按月/小时细分任何用户或项目的工时。

快速开始（推荐使用Docker）

针对Cursor/Claude的MCP服务器配置

在您的Cursor或Claude的settings.json中添加以下内容（替换YOUR_API_KEY）：

{
  "mcpServers": {
    "clockify-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CLOCKIFY_API_KEY=<YOUR_API_KEY>",
        "ghcr.io/inakianduaga/clockify-mcp:latest"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

如何获取Clockify API密钥

1. 登录到您的Clockify账户。
2. 点击右上角的个人资料图标并选择Profile。
3. 向下滚动至API部分。
4. 如果没有API密钥，请点击Generate，或者复制您现有的密钥。

贡献及CI/CD

该项目使用GitHub Actions，在每次向main分支推送代码时自动构建并发布Docker镜像到GitHub容器注册表（GHCR）。

• 镜像URL: ghcr.io/inakianduaga/clockify-mcp:latest
• 如何拉取镜像:

  docker pull ghcr.io/inakianduaga/clockify-mcp:latest
  

您可以在GitHub个人资料或仓库的“Packages”部分查看已发布的镜像。

内存库及优化

开发过程中使用了cursor以及优化规则。详情见：https://github.com/Bhartendu-Kumar/rules_template

许可证

本项目采用MIT许可证。详情见LICENSE文件。