@shiftzap/mcp-server

@shiftzap/mcp-server

MCP (Model Context Protocol) server for the ShiftZap restaurant workforce scheduling API. Lets AI assistants manage stores, employees, schedules, time-off, webhooks, tips, payroll, and more.

Quick Start

cd packages/mcp-server
npm install
npm run build

Claude Desktop Configuration

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shiftzap": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "SHIFTZAP_API_KEY": "sz_live_your_key_here"
      }
    }
  }
}

Or if published to npm:

{
  "mcpServers": {
    "shiftzap": {
      "command": "npx",
      "args": ["-y", "@shiftzap/mcp-server"],
      "env": {
        "SHIFTZAP_API_KEY": "sz_live_your_key_here"
      }
    }
  }
}

Available Tools (28)

Meta

Tool	Description
get_api_key_info	Get API key info, plan tier, rate limits, and accessible stores

Stores

Tool	Description
list_stores	List all stores accessible with this API key
get_store	Get store details including hours, roles, and shifts

Employees

Tool	Description
list_employees	List employees, optionally filtered by role (paginated)
create_employee	Create a new employee
get_employee	Get employee details with availability and time-off
update_employee	Update employee fields
delete_employee	Permanently delete an employee
batch_create_employees	Create up to 50 employees at once
replace_availability	Replace all weekly availability for an employee

Time Off

Tool	Description
create_time_off_request	Create a time-off request for an employee
update_time_off_request	Approve or deny a pending time-off request

Schedules

Tool	Description
list_schedules	List schedules filtered by status or week
get_current_schedule	Get current/upcoming posted schedule with shifts
get_schedule	Get a specific schedule with all assignments
update_schedule_status	Post or archive a schedule

Webhooks

Tool	Description
list_webhooks	List webhook endpoints for a store
create_webhook	Create a webhook endpoint (max 10 per store)
update_webhook	Update webhook URL, events, or active status
delete_webhook	Delete a webhook and its delivery history

Tips & Payroll

Tool	Description
list_tip_sources	List imported POS tip data sources
list_tip_payouts	List tip payouts by period or employee
list_payroll_runs	List payroll export history

Feed

Tool	Description
list_feed_posts	List team feed/announcement posts
create_feed_post	Create a team announcement

Shift Requests

Tool	Description
list_shift_requests	List shift swap/cover requests
create_shift_request	Post a shift for swap/cover
update_shift_request	Claim or cancel a shift request

Authentication

Get your API key from ShiftZap Dashboard > Integrations > API Keys.

The server reads SHIFTZAP_API_KEY from the environment. All requests are sent with Authorization: Bearer <key> to https://api.shiftzap.ai.

Development

npm run dev    # Watch mode (tsc --watch)
npm run build  # One-shot compile
npm start      # Run the server