AI Integration

New

Manage PTO with your AI

Connect Claude, Cursor, VS Code, or any MCP-compatible AI assistant to BookYourPTO. 34 tools for leave, expenses, time tracking, and more — through natural language.

Start Free See Docs

Claude Code

❯ show me my days off this week

▸ bookyourpto - query_leaves (MCP)

┌──────────┬────────────────────┬──────┐

│ Mon, Mar 9 │ Working from home │ 1d │

│ Fri, Mar 13│ Annual Leave │ 1d │

└──────────┴────────────────────┴──────┘

2 days off this week — WFH today, vacation on Friday.

❯ what's my schedule for tomorrow?

▸ bookyourpto - query_schedules (MCP)

Tomorrow (Tue, Mar 10): 8:30 AM – 4:30 PM in office, 8 hours.

Getting Started

Three steps to AI-powered PTO

Set up once, use everywhere. No API keys to manage.

Step 1

Connect

Add BookYourPTO to your AI client in one command. SSE or Docker — your choice.

Step 2

Authenticate

Step 3

Use

Ask naturally. The AI calls the right tools for you — leave, expenses, time tracking, and more.

Compatibility

Works with your favorite AI tools

One server, every client. Pick yours and connect in seconds.

Terminal

$ claude mcp add --transport sse \
  BookYourPTO \
  https://mcp.bookyourpto.com/sse

Run this once — Claude Code remembers your MCP servers

Capabilities

34 tools across 8 categories

Read and write access to your entire workspace.

Leave Management

Query balances, create leave requests, approve or reject, and check team availability

get_leave_balancecreate_leave_requestquery_leavesapprove_leavereject_leave

Expenses

Create and manage expense reports, submit for approval, mark as paid, view settings and details

query_expensesget_expense_detailscreate_expensesubmit_expensemark_expense_paidget_expense_settingsget_expense_approvalsapprove_or_reject_expense

Time Tracking

Clock in/out, manage breaks, and query time entries

People

Team members, profiles, and department lookups

Schedules

View shifts, create shifts, and publish schedules

Projects

List projects, view details, and create tasks

Organization

Org info, holidays, stats, and notifications

Reports

Leave and timesheet reports with custom filters

21 read tools

13 write tools

8 categories

Security

Enterprise-grade by default

Your credentials never leave BookYourPTO. The MCP server is a stateless bridge.

How authentication flows

AI client opens your browser

OAuth 2.0 + PKCE authorization request

You sign in on BookYourPTO

Password + optional 2FA — stays here

Secure

Short-lived JWT token issued

Scoped to your role — no password included

AI calls tools with token

MCP server verifies locally, never stores

Live

OAuth 2.0 + PKCE

Role-Based Access

2FA Supported

Zero Credential Storage

Self-Hosting

Self-hosting with Docker

Run the MCP server yourself using the public Docker image. Useful for teams that want full control or need to run on their own infrastructure.

Public image on Docker Hub — no build step required
Full control over your infrastructure and data
Credentials stay on your server as environment variables
Connect AI clients to localhost instead of hosted URL

Terminal

# Pull and run

$ docker pull bookyourpto/mcp-server:latest

$ docker run -d \

--name bookyourpto-mcp \

-e BYPTO_EMAIL=your-email@company.com \

-e BYPTO_PASSWORD=your-password \

-e MCP_TRANSPORT=http \

-p 8000:8000 \

bookyourpto/mcp-server:latest

# Verify it's running

$ curl http://localhost:8000/health

Credentials stay on your server. Connect AI clients to localhost:8000/sse instead of the hosted URL. If your account uses 2FA, use an account without 2FA for the self-hosted server.

Ready to connect your AI?

34 tools, natural language, works with Claude, Cursor, VS Code, and more.

Get Started Free Read the Docs

14-day free trial · Cancel anytime