kairos-mcp

Kairos 时间管理工具的 MCP Server，让你在 Claude Code 中直接操作任务、项目、专注计时和统计数据。

安装

在 Claude Code 配置中添加：

{
  "mcpServers": {
    "kairos": {
      "command": "npx",
      "args": ["-y", "kairos-mcp"]
    }
  }
}

重启 Claude Code 后，首次调用任意工具会打开浏览器登录 Kairos，之后自动使用缓存 token。

可用工具

任务管理

• list_tasks - 列出任务（支持按项目/状态/优先级/关键词筛选）
• get_task - 获取任务详情
• create_task - 创建任务
• update_task - 更新任务
• delete_task - 删除任务
• complete_task - 标记任务完成

项目管理

• list_boards - 列出所有项目
• get_board - 获取项目详情（含任务统计）
• create_board - 创建项目
• update_board - 更新项目
• delete_board - 删除项目及其任务

专注计时

• log_focus_session - 记录一次专注时间
• get_time_records - 查询时间记录
• get_today_records - 获取今日专注记录

统计

• get_stats - 总番茄数/总专注时长
• get_heatmap - 年度热力图数据
• get_daily_summary - 某日详细统计

活动日志

• get_activity_log - 获取最近活动
• log_activity - 记录活动

认证

首次使用时会自动打开浏览器进行 Kairos 登录，token 缓存到 ~/.kairos/token.json，过期后自动刷新。