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

A
Description quality
100%
Schema completeness
90%
Naming quality
69%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (4)

  • LOWTool 'workschedulenet_list_category_items' name length outside 3-30 rangein workschedulenet_list_category_items
  • LOWTool 'workschedulenet_get_category_item' name length outside 3-30 rangein workschedulenet_get_category_item
  • LOWTool 'workschedulenet_create_timeblock' name length outside 3-30 rangein workschedulenet_create_timeblock
  • LOWTool 'workschedulenet_update_timeblock' name length outside 3-30 rangein workschedulenet_update_timeblock

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,623Tokens (tool definitions)
~1.9 KBTypical response size
Moderate attention impact (1.27% of 128k context)

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-http

What it can do

Tool inventory

Tools (7)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded7 tools