Model Context Protocol Server
Staffcloud.
AI-Connected.
119 tools that connect Claude to the Staffcloud API. Create projects, events, functions, and manage your staffing — all through natural language.
Get Started Model Context Protocol Server
119 tools that connect Claude to the Staffcloud API. Create projects, events, functions, and manage your staffing — all through natural language.
Get StartedSetup
Request an API key from Staffcloud Support. Staffcloud charges a fee for creating the API key.
API keys are under fair use policy with up to 20,000 requests per day — more than enough for multiple power users. Higher limits available by contacting support.
$ git clone https://github.com/Umami2000/staffcloud-mcp.git$ cd staffcloud-mcp && npm install# Dependencies install and TypeScript builds automatically $ npm run setup# Validates connection, picks modules, writes config > "List all projects"# That's it — tools are live What You Can Do
Create, update, list, and manage projects. Bulk create from Excel or conversation.
create_projectupdate_projectget_projectlist_projectsbulk_create_projects Create shifts with automatic Swiss break calculation. Bulk import with dry-run preview.
create_eventupdate_eventget_eventlist_eventsbulk_create_events Define roles and positions per event. Bartender, Promoter, Team Lead — with headcount.
create_event_functionupdate_event_functionlist_event_functionsbulk_create_event_functions Manage client companies and their contacts. Link to projects for billing and communication.
create_clientupdate_clientcreate_contactupdate_contactlist_clients Create and manage event locations with addresses. Assign to events for on-site coordination.
create_locationupdate_locationlist_locations Define shift times with automatic ArG Art. 15 break calculation. Swiss labor law compliant.
create_shiftget_eventlist_events Find available staff, detect staffing gaps, get replacement candidates — all in one call.
find_available_staffget_staffing_gapsfind_replacementget_staff_schedule Coming Soon
Invite, assign, confirm, and manage staff assignments to events. Update status in bulk.
update_assignment_statusbulk_update_assignment_statuslist_assignmentsget_assignment See It In Action
Create a project "Zurich Wine Festival" for client Mövenpick, then add 12 events next week, 9h shifts starting at 8am, each needing 3 bartenders
Created project "Zurich Wine Festival" (ID: 2847) Dry-run preview for 12 events: Mon Mar 30 — 08:00-17:00 (break 12:00-13:00, ArG Art. 15) Tue Mar 31 — 08:00-17:00 (break 12:00-13:00, ArG Art. 15) ... 10 more events Swiss breaks auto-applied: 60min (shift >9h) Event function: Bartender (x3 positions each) Confirm to create? (or adjust)
Update all events for project 2847 to start at 9am instead of 8am, and change the function from Bartender to Sommelier
Updated 12 events in project "Zurich Wine Festival": New time: 09:00-18:00 (break 13:00-14:00, recalculated) Function updated: Bartender -> Sommelier (x3 positions) 12/12 events updated successfully.
Architecture
5 independent modules keep context windows lean. Load 27 core tools or all 119.
core default Employees, projects, events, assignments, scheduling
setup Clients, contacts, event functions, locations, bulk import
ops Wages, paysheets, work-times, checkins, ratings
admin Webhooks, messages, external staff, files
reference Settings, planners, languages, wage profiles
{
"mcpServers": {
"staffcloud": {
"command": "node",
"args": ["/path/to/staffcloud-mcp/dist/index.js"],
"env": {
"STAFFCLOUD_API_URL": "https://yourcompany.staff.cloud/api/v1",
"STAFFCLOUD_API_KEY": "your-jwt-token",
"STAFFCLOUD_MODULES": "core,setup"
}
}
}
}Built With