Overview

What is BookYourPTO MCP?

BookYourPTO MCP is a hosted server that gives AI tools secure access to your BookYourPTO workspace. Built on the Model Context Protocol (MCP) open standard, it lets AI assistants like Claude Code, Cursor, VS Code Copilot, Claude Desktop, and more interact with your HR data.

How It Works

┌─────────────────┐       SSE        ┌──────────────────┐      REST API     ┌──────────────────┐
│   AI Client     │ ◄──────────────► │  BookYourPTO MCP │ ◄───────────────► │  BookYourPTO API │
│ (Claude, Cursor │   Tool calls &   │  Server (hosted) │   Authenticated   │  (app.bookyourpto│
│  VS Code, etc.) │   responses      │  mcp.bookyourpto │   API requests    │  .com)           │
└─────────────────┘                  │  .com            │                   └──────────────────┘
                                     └──────────────────┘

1. Your AI client connects to mcp.bookyourpto.com/sse via Server-Sent Events (SSE)
2. The MCP server prompts you to sign in via your browser (standard OAuth 2.0 flow) — your password never touches the AI
3. When the AI needs to take an action (e.g., check leave balance), it calls the appropriate MCP tool
4. The MCP server makes authenticated API requests to BookYourPTO on your behalf
5. Results are returned to the AI client, which formats them into a natural response

What Can You Do?

With BookYourPTO MCP, your AI assistant can:

• Manage leaves — Check balances, submit leave requests, approve or reject pending requests
• Track time — Clock in/out, start/end breaks, query time entries
• Handle expenses — Query expense reports, view details, approve or reject submissions
• View schedules — See upcoming shifts, create new shifts, publish weekly schedules
• Manage projects — List projects, view details, create tasks
• Access reports — Generate leave and timesheet reports
• Organization info — View team members, departments, public holidays, dashboard stats

Available Tools

BookYourPTO MCP provides 28 tools across 9 categories:

See the Tools Reference for complete documentation of every tool and its parameters.

Requirements

• A BookYourPTO Cloud account (Pro, Business, or Enterprise plan)
• An MCP-compatible AI client (see Connecting)
• Your BookYourPTO credentials (you'll sign in via your browser when first connecting)

Resources

The MCP server also exposes read-only resources that provide context to AI clients:

• bypto://org-settings — Organization configuration (timezone, currency, fiscal year)
• bypto://leave-types — Available leave types and their settings
• bypto://team-directory — Team members with roles and departments