Connect AI Agents via MCP

What is MCP (Model Context Protocol)?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. By integrating ShiftScheduler with MCP, you can let AI agents like Claude, ChatGPT, or custom LLM applications read and manage your person planning data through natural language.

What Can AI Agents Do?

Once connected via MCP, AI agents can perform intelligent operations on your workspace:

• Search & Query: “Show me all locations John is working on this month“ or “Who is available next week?“
• Create Shifts: “Assign Sarah to the Mobile App location for 6 hours per day starting Monday“
• Vacation Planning: “Show me all vacations in December“ or “What locations would be affected if Tom takes time off next week?“
• Workload Analysis: “Give me an overview of next week's shifts grouped by location and person“
• Location Intelligence: “Who worked on the Website Redesign location and when?“
• Weekly Reports: “Give me an overview of next week's shifts grouped by location“

Getting Started

Step 1: Generate Your MCP Key

1. Log in to ShiftScheduler and navigate to Settings
2. Scroll to the MCP (Model Context Protocol) section
3. Click Generate new key
4. Copy the displayed key immediately – it will only be shown once

Step 2: Configure Your AI Assistant

For ChatGPT Agent

URL: https://shiftscheduler.ai/api/mcp

Authorization: Bearer YOUR_MCP_KEY_HERE

Instructions (just for inspiration, feel free to use your own): You are helper for location manager with access to ShiftScheduler application and you are able to answer questions about shifts, locations persons (team members) or vacations.

If successful, you'll receive a list of available tools that the AI can use to interact with your workspace.

Available MCP Tools

The ShiftScheduler MCP server provides the following tools for AI agents. Tool names use the shiftscheduler-* prefix.

Core Operations

• shiftscheduler-search – Search locations, persons, and shifts by keyword
• shiftscheduler-list – List all locations, persons, or shifts with pagination
• shiftscheduler-create-people – Create one or more scheduling-only people or invited workspace members. Role and membership settings require invited=true
• shiftscheduler-create-locations – Create one or more locations in the workspace
• shiftscheduler-create-shift-templates – Create one or more regular or Time Off templates and optionally assign regular templates to weekdays
• shiftscheduler-update-shift-templates – Update one or more templates or convert between regular and Time Off types
• shiftscheduler-delete-shift-templates – Delete one or more templates and clean their open-slot schedule references
• shiftscheduler-assign – Create a new shift for a person in a location
• shiftscheduler-update-shift – Modify an existing shift (dates, hours, notes)
• shiftscheduler-delete-shifts – Remove shifts in a date range (max 31 days; optional filters)

Time-Off & Vacation Management

• shiftscheduler-vacations – Show all vacations/time-off in a date range, grouped by person

Location Intelligence

• shiftscheduler-location-history – List all persons who worked on a location during a date range with total hours

Planning & Reporting

• shiftscheduler-notes-timeline – Search for phrases in shift notes and return chronological timeline

Need Help?

If you encounter issues: Contact me at adam@shiftscheduler.ai