When I Work MCP by usefulapi

usefulapi 提供的 When I Work MCP

通过 Claude、Cursor 或任何 MCP 客户端使用 When I Work——查看日程、班次、打卡时间、休假申请、换班和可用时间，并创建、发布或更新班次。 托管服务，无需本地安装：使用你自己的 When I Work 凭据连接。

在线端点： https://when-i-work.usefulapi.io/mcp · 主页： https://usefulapi.io/when-i-work

连接

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

{
  "mcpServers": {
    "when-i-work": {
      "url": "https://when-i-work.usefulapi.io/mcp"
    }
  }
}

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

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/when-i-work/

首次连接时，你需要提供 When I Work 开发者密钥（W-Key）、电子邮件和密码，以及可选的工作场所用户 ID。 系统会验证这些信息，按用户存储并限定为你本人使用——配置文件中不会包含密钥。

工具

工具	类型	功能
wheniwork_get_account	读取	获取账户
wheniwork_list_users	读取	列出用户
wheniwork_get_user	读取	获取单个用户
wheniwork_list_locations	读取	列出日程（地点）
wheniwork_list_positions	读取	列出职位
wheniwork_list_shifts	读取	列出班次
wheniwork_get_shift	读取	获取单个班次
wheniwork_list_eligible_users_for_shift	读取	列出符合开放班次条件的用户
wheniwork_list_times	读取	列出打卡时间（工时表）
wheniwork_list_time_off_requests	读取	列出休假申请
wheniwork_get_time_off_request	读取	获取单个休假申请
wheniwork_list_time_off_types	读取	列出休假类型
wheniwork_list_shift_swaps	读取	列出换班和放弃班次记录
wheniwork_list_availability	读取	列出可用时间
wheniwork_list_annotations	读取	列出日程备注
wheniwork_create_shift	写入	创建班次
wheniwork_update_shift	写入	更新班次
wheniwork_publish_shifts	写入	发布班次
wheniwork_unpublish_shifts	写入	取消发布班次
wheniwork_create_time_off_request	写入	创建休假申请
wheniwork_update_time_off_request	写入	批准、拒绝或更改休假申请
wheniwork_usage_status	元信息	使用情况（免费套餐用量）
wheniwork_request_feature	元信息	申请添加缺失功能
wheniwork_upgrade	元信息	升级到 Pro（无限量*）
wheniwork_cancel_subscription	元信息	取消 Pro 订阅

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

定价

套餐	价格	限额
免费版	$0	每月 50 次工具调用
Pro（按用户计费）	$9/月 或 $90/年（免费 2 个月）	无限量*

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

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

许可证

MIT © usefulapi。与 When I Work 无关联，也未获得其认可。