此 MCP 服务器允许 LLMs( 如 Cursor 或 Claude) 与您的 Clockify 工作空间交互, 允许高级时间跟踪自动化和报告 。 使用此服务器,您可以:

• 列出您工作空间中的所有工程
• 列出工作空间中的所有用户
• 为你自己或任何用户添加和查询时间项(如果您有权限)
• 为所有项目的任何用户提取计时表
• 根据用户和项目,利用时钟汇总报告API,生成月度或自定义日期范围小时细目
• 与 LLMS 整合,使您的时间跟踪数据自动化、归纳或分析

□ 特性

• 清单项目: 为认证的用户列出所有工程
• 获得时间:** 列出认证用户的时间条目( 带有可选日期过滤器)
• ** 添加时间:** 向工程添加时间项
• 列表用户: 列出工作空间中的所有用户
• 用户时间:** 列出任何用户的时间条目( 带有可选日期过滤器)
• 总报告: 按用户/项目获取一个日期范围的小时简要报告(可选由用户IDs/项目IDs过滤). 允许任何用户或项目的月/小时分解 。

□快起(Docker-首选)

Clockify MCP Server

This MCP server allows LLMs (such as Cursor or Claude) to interact with your Clockify workspace, enabling advanced time-tracking automation and reporting. With this server, you can:

• List all projects in your workspace
• List all users in your workspace
• Add and look up time entries for yourself or any user (if you have permissions)
• Pull timesheets for any user across all projects
• Generate monthly or custom date range breakdowns of hours by user and project using the Clockify summary report API
• Integrate with LLMs to automate, summarize, or analyze your time-tracking data

Features

• listProjects: List all projects for the authenticated user
• getTimeEntries: List time entries for the authenticated user (with optional date filters)
• addTimeEntry: Add time entries to a project
• listUsers: List all users in the workspace
• getUserTimeEntries: List time entries for any user (with optional date filters)
• getSummaryReport: Get a summary report of hours by user/project for a date range (optionally filtered by userIds/projectIds). Enables monthly/hourly breakdowns for any user or project.

Quick Start (Docker — Preferred)

MCP Server Configuration for Cursor/Claude

Add the following to your Cursor or Claude settings.json (replace YOUR_API_KEY):

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

How to Obtain a Clockify API Key

1. Log in to your Clockify account.
2. Click on your profile icon (top right) and select Profile.
3. Scroll down to the API section.
4. Click Generate if you don’t have an API key, or copy your existing key.

Contributing & CI/CD

This project uses GitHub Actions to automatically build and publish the Docker image to GitHub Container Registry (GHCR) on every push to main.

• Image URL: ghcr.io/inakianduaga/clockify-mcp:latest
• How to pull the image:

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