INDIVIDUAL MCP TOOL

wheniwork_create_time_off_request

Create a time-off request for a user (default the calling user).

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://when-i-work.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for wheniwork_create_time_off_request and invoke it with your own arguments.

{}

Potential side effects detected · medium confidence · heuristic, not a guarantee.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.when-i-work-mcp]
url = "https://when-i-work.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

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

Claude Desktop

Settings → Connectors → Add custom connector

Name: when-i-work-mcp
Remote MCP URL: https://when-i-work.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

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

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

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

Generic MCP

Client-specific MCP configuration

{
  "name": "when-i-work-mcp",
  "transport": "streamable-http",
  "url": "https://when-i-work.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

wheniwork_get_account — Fetch the When I Work account (workplace) the token acts on — company name, plan and settings; for a parent account also its child accounts.
wheniwork_list_users — List the employees, supervisors, managers and admins in the account, optionally limited to some schedules or searched by name/email.
wheniwork_get_user — Fetch one user by id — name, email, role, positions, schedules, wage.
wheniwork_list_locations — List the schedules in the account.
wheniwork_list_positions — List the positions (job roles such as Cashier or Dishwasher) in the account.
wheniwork_list_shifts — List scheduled shifts in a time window — who works when, where and in which position — optionally including open shifts and unpublished drafts.
wheniwork_get_shift — Fetch one shift by id, including its breaks and publish state.
wheniwork_list_eligible_users_for_shift — Find who could take an open shift — either an existing shift (shift_id) or a hypothetical one (start, end, position_id and location_id all required).