WorkSchedule.Net MCP by usefulapi
Read users, categories and time blocks, and create or update shifts in WorkSchedule.Net.
Should I use this
Quality & Safety
Findings (4)
- LOWin workschedulenet_list_category_items
- LOWin workschedulenet_get_category_item
- LOWin workschedulenet_create_timeblock
- LOWin workschedulenet_update_timeblock
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"workschedule-net": {
"url": "https://workschedule-net.usefulapi.io/mcp"
}
}
}Remote endpoints
https://workschedule-net.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (7)
🟢workschedulenet_list_users
List every user account in the company, with names, UserID, ExternalID, role and department. Use it to find the UserID for a shift. WorkSchedule.Net API: GET /User.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢workschedulenet_get_user(id, lookup_key)
Read one user account by UserID or ExternalID. WorkSchedule.Net API: GET /User/{id}, Lookup-Key header.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The id value, matching the lookup key."
},
"lookup_key": {
"default": "UserID",
"description": "Which id the value is: UserID (default) or ExternalID.",
"type": "string",
"enum": [
"UserID",
"ExternalID"
]
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢workschedulenet_list_category_items(category)
List every item in one category, such as Locations, Areas or Departments, with CatItemID. Use the IDs in shift CategoryItems. WorkSchedule.Net API: GET /CategoryItem/{CatName}.
Input Schema
{
"type": "object",
"properties": {
"category": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Category name, for example Location, Area, Department or Tasks."
}
},
"required": [
"category"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢workschedulenet_get_category_item(category, id, lookup_key)
Read one category item by CatItemID or ExternalID. WorkSchedule.Net API: GET /CategoryItem/{CatName}/{id}, Lookup-Key header.
Input Schema
{
"type": "object",
"properties": {
"category": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Category name, for example Location, Area, Department or Tasks."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The id value, matching the lookup key."
},
"lookup_key": {
"default": "CatItemID",
"description": "Which id the value is: CatItemID (default) or ExternalID.",
"type": "string",
"enum": [
"CatItemID",
"ExternalID"
]
}
},
"required": [
"category",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢workschedulenet_get_timeblock(calendar, id, lookup_key)
Read one shift or time-off block by TimeBlockID or ExternalID, from the Schedule or Attendance calendar. WorkSchedule.Net API: GET /TimeBlock/{calendar}/{id}.
Input Schema
{
"type": "object",
"properties": {
"calendar": {
"type": "string",
"enum": [
"Schedule",
"Attendance"
],
"description": "Schedule for shifts, Attendance for time-off and attendance blocks."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The id value, matching the lookup key."
},
"lookup_key": {
"default": "TimeBlockID",
"description": "Which id the value is: TimeBlockID (default) or ExternalID.",
"type": "string",
"enum": [
"TimeBlockID",
"ExternalID"
]
}
},
"required": [
"calendar",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴workschedulenet_create_timeblock(calendar, user_id, start_time, end_time, notes, ...)
Create a shift or time-off block for a user, or an open shift with user_id "0". This writes to the live schedule. WorkSchedule.Net API: POST /TimeBlock/{calendar}.
Input Schema
{
"type": "object",
"properties": {
"calendar": {
"type": "string",
"enum": [
"Schedule",
"Attendance"
],
"description": "Schedule for shifts, Attendance for time-off and attendance blocks."
},
"user_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "UserID of the assigned user, or 0 for an open shift."
},
"start_time": {
"type": "string",
"description": "ISO-8601 local time, for example 2026-11-20T09:00:00. The API reads it in the API user's default time zone."
},
"end_time": {
"type": "string",
"description": "ISO-8601 local time, for example 2026-11-20T09:00:00. The API reads it in the API user's default time zone."
},
"notes": {
"description": "Free-text notes on the time block.",
"type": "string",
"maxLength": 2000
},
"color": {
"description": "Hex colour, for example 00FF00.",
"type": "string",
"pattern": "^[0-9A-Fa-f]{6}$"
},
"external_id": {
"description": "Your own id for this record in another system.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"category_items": {
"description": "Map of category name to Category Item ID, for example {\"Location\": \"1\", \"Area\": \"11\"}.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"calendar",
"user_id",
"start_time",
"end_time"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴workschedulenet_update_timeblock(calendar, id, lookup_key, user_id, start_time, ...)
Change one shift or time-off block: user, times, notes, colour, external id or category items. Send only the fields to change. This writes to the live schedule. WorkSchedule.Net API: PUT /TimeBlock/{calendar}/{id}.
Input Schema
{
"type": "object",
"properties": {
"calendar": {
"type": "string",
"enum": [
"Schedule",
"Attendance"
],
"description": "Schedule for shifts, Attendance for time-off and attendance blocks."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The id value, matching the lookup key."
},
"lookup_key": {
"default": "TimeBlockID",
"description": "Which id the value is: TimeBlockID (default) or ExternalID.",
"type": "string",
"enum": [
"TimeBlockID",
"ExternalID"
]
},
"user_id": {
"description": "New UserID, or 0 for an open shift.",
"type": "string",
"pattern": "^\\d+$"
},
"start_time": {
"type": "string",
"description": "ISO-8601 local time, for example 2026-11-20T09:00:00. The API reads it in the API user's default time zone."
},
"end_time": {
"type": "string",
"description": "ISO-8601 local time, for example 2026-11-20T09:00:00. The API reads it in the API user's default time zone."
},
"notes": {
"description": "Free-text notes on the time block.",
"type": "string",
"maxLength": 2000
},
"color": {
"description": "Hex colour, for example 00FF00.",
"type": "string",
"pattern": "^[0-9A-Fa-f]{6}$"
},
"external_id": {
"description": "Your own id for this record in another system.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"category_items": {
"description": "Map of category name to Category Item ID, for example {\"Location\": \"1\", \"Area\": \"11\"}.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"calendar",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence