When I Work

io.usefulapiv1.0.0Updated Sep 30, 2026

Check shifts, time clock entries, time-off requests, swaps and availability, and manage shifts.

VerifiedStreamable HTTPWeb executableBusiness & CommerceProductivity & Workflow

Overview

AI-generated overview

Lets an assistant read and manage When I Work schedules, shifts, timesheets, time-off requests, swaps and availability.

What it does
Connects to a hosted When I Work endpoint and exposes read tools for the account, users, schedules (locations), positions, shifts, clocked times, time-off requests and types, shift swaps and drops, availability and schedule annotations. Write tools create, update, publish and unpublish shifts, and create or approve, deny and change time-off requests. Two meta tools report usage and manage the subscription.
When to use it
Useful when a manager or scheduler wants to check or adjust staffing from an assistant: reviewing who is scheduled, looking at clocked hours or pending time-off and swap requests, or creating and publishing shifts without opening the When I Work interface.
Requirements
Remote streamable HTTP endpoint; no local install. On first connect you supply your When I Work developer key (W-Key), email and password, plus an optional workplace user id; these are validated and stored per user. Network access to the hosted endpoint is required.
Before you install
The server asks for your When I Work developer key (W-Key), email and password, which are stored per user on the provider's side. Write tools create, update, publish or unpublish shifts and create or change time-off requests, so changes affect real schedules and staff. The free tier is limited to 100 tool calls per month; Pro is $9/mo or $90/yr per user.

Installation

In SourceWeft

  1. Open When I Work in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

When I Work MCP by usefulapi

Use When I Work from Claude, Cursor, or any MCP client — check schedules, shifts, clocked times, time-off requests, shift swaps and availability, and create, publish or update shifts. Hosted, no local install: connect with your own When I Work credentials.

Live endpoint: https://when-i-work.usefulapi.io/mcp · Homepage: https://usefulapi.io/when-i-work

Add to Claude

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

On first connect you'll provide your When I Work developer key (W-Key), email and password, plus an optional workplace user id. They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
wheniwork_get_accountreadGet the account
wheniwork_list_usersreadList users
wheniwork_get_userreadGet one user
wheniwork_list_locationsreadList schedules (locations)
wheniwork_list_positionsreadList positions
wheniwork_list_shiftsreadList shifts
wheniwork_get_shiftreadGet one shift
wheniwork_list_eligible_users_for_shiftreadList users eligible for an open shift
wheniwork_list_timesreadList clocked times (timesheets)
wheniwork_list_time_off_requestsreadList time-off requests
wheniwork_get_time_off_requestreadGet one time-off request
wheniwork_list_time_off_typesreadList time-off types
wheniwork_list_shift_swapsreadList shift swaps and drops
wheniwork_list_availabilityreadList availability
wheniwork_list_annotationsreadList schedule annotations
wheniwork_create_shiftwriteCreate a shift
wheniwork_update_shiftwriteUpdate a shift
wheniwork_publish_shiftswritePublish shifts
wheniwork_unpublish_shiftswriteUnpublish shifts
wheniwork_create_time_off_requestwriteCreate a time-off request
wheniwork_update_time_off_requestwriteApprove, deny or change a time-off request
wheniwork_usage_statusmetaUsage status (free-tier meter)
wheniwork_upgrademetaUpgrade to Pro (unlimited)

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage or manage your subscription.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

License

MIT © usefulapi. Not affiliated with or endorsed by When I Work.

Source: servers/when-i-work/README.md at commit 1ec23c2

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestSep 30, 2026