Clockify MCP

Clockify MCP 服务器

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

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

特征

• **listProjects：**列出经过身份验证的用户的所有项目
• **getTimeEntries：**列出经过身份验证的用户的时间条目（带有可选的日期过滤器）
• **addTimeEntry：**向项目添加时间条目
• **listUsers：**列出工作区中的所有用户
• **getUserTimeEntries：**列出任何用户的时间条目（带有可选的日期过滤器）
• **getSummaryReport：**获取特定日期范围内按用户/项目统计的小时数摘要报告（可选择按用户 ID/项目 ID 筛选）。支持按月/小时细分任何用户或项目。

快速入门（Docker — 首选）

Cursor/Claude 的 MCP 服务器配置

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

如何获取 Clockify API 密钥

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

贡献 & CI/CD

该项目使用 GitHub Actions 在每次推送到main时自动构建并将 Docker 镜像发布到 GitHub Container Registry (GHCR)。

• 图片网址： ghcr.io/inakianduaga/clockify-mcp:latest :latest
• 如何拉取镜像：
  docker pull ghcr.io/inakianduaga/clockify-mcp:latest

您可以在 GitHub 个人资料或存储库的“包”部分查看已发布的图像。

存储库和优化

开发过程中使用了游标和优化规则。详情请参阅： https://github.com/Bhartendu-Kumar/rules\ _template