Timebutler MCP by usefulapi

usefulapi 的 Timebutler MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Timebutler 账户。它可以读取缺勤记录、工时记录、休假余额，以及经理可查看的团队申请；还可以打卡和申请缺勤。托管服务，无需本地安装：使用你自己的凭据连接。

实时端点： https://timebutler.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、桌面版）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://timebutler.usefulapi.io/mcp。
• Claude Code： 运行 claude mcp add --transport http timebutler https://timebutler.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "timebutler": {
      "url": "https://timebutler.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Timebutler 凭据。

分步设置说明、凭据查找方式和常见问题：https://usefulapi.io/timebutler/

首次连接时，你需要提供 Timebutler 个人访问令牌（令牌以 tb_ 开头；请在 Timebutler 账户设置中的个人访问令牌下创建）。服务会验证令牌并按用户存储。无需将密钥放入配置文件。

工具

工具	类型	功能
timebutler_get_profile	read	获取我的个人资料
timebutler_list_employees	read	列出员工
timebutler_list_absence_types	read	列出缺勤类型
timebutler_list_categories	read	列出工时类别
timebutler_list_projects	read	列出项目
timebutler_list_my_absence_requests	read	列出我的缺勤申请
timebutler_list_team_absence_requests	read	列出团队缺勤申请
timebutler_get_absence_pending_count	read	统计待处理的缺勤申请
timebutler_list_my_time_entries	read	列出我的工时记录
timebutler_get_time_entry_pending_count	read	统计待处理的工时记录
timebutler_list_time_entry_requests	read	列出工时记录申请
timebutler_get_time_clock_status	read	获取打卡状态
timebutler_get_work_summary	read	获取今日工作摘要
timebutler_get_time_off_summary	read	获取休假摘要
timebutler_clock_start	write	开始计时
timebutler_clock_pause	write	暂停计时
timebutler_clock_resume	write	恢复计时
timebutler_clock_stop	write	停止计时并保存
timebutler_submit_clock_entry	write	提交已完成的工时记录
timebutler_create_absence_request	write	申请缺勤
timebutler_usage_status	meta	使用情况（免费套餐用量计量）
timebutler_request_feature	meta	申请添加缺失的功能
timebutler_upgrade	meta	升级到 Pro（无限使用*）
timebutler_cancel_subscription	meta	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先确认）；meta 工具用于报告使用情况、管理订阅或发送功能申请。

定价

方案	价格	限额
免费	$0	每月 50 次工具调用
专业版（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限制*

*专业版在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

专业版仅适用于此服务。使用 timebutler_upgrade 订阅（它会返回一个 Stripe Checkout 链接）。使用 timebutler_cancel_subscription 可随时取消：专业版会持续至付费周期结束，当前周期不予退款；在此之前运行 timebutler_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT — 请参阅 LICENSE。仅提供文档；服务托管在远程服务器上。