← All 13 Plugins

Kairos

Appointment Booking Engine

Καιρός (Kairós) — The opportune, critical moment. In Greek philosophy, Kairos is qualitative time—the supreme decisive moment of action and opportunity, contrasting with linear chronological time (Chronos).

Category: Operations & Business Version: 1.0.0 Requirements: PHP 7.4+ · WP 6.0+ Runtime: <45kb React UI · Bidirectional sync

Overview

Kairos (Greek for the right, critical, or opportune moment) is a high-end, feature-rich appointment booking engine built specifically for WordPress. Designed for salons, spas, clinics, and service professionals, Kairos replaces clunky booking plugins with a modern, dynamic, and fast React-powered frontend interface and a deeply integrated WordPress backend.

Architectural Rationale: Standard WordPress booking plugins rely on bloated Custom Post Types for every reservation, causing database bloat and frustrating clients with clunky multi-step checkouts. Kairos is built with lean custom tables, a sub-45kb React booking widget, real-time bidirectional Google Calendar synchronization, and native Model Context Protocol (MCP) scheduling endpoints for AI assistants.

Key Features

  • Visual Multi-Provider Grid

    Color-coded daily timeline view of your entire staff schedule directly in the WordPress dashboard.

  • Provider-Service Mapping

    Assign specific services, variable durations, and custom pricing to individual team members.

  • Client CRM & Trust Scoring

    Centralized client profiles with appointment histories and automated no-show tracking.

  • 2-Way Google Calendar Sync

    Real-time bidirectional synchronization prevents double-booking with external personal schedules.

  • Modern React Frontend

    Lightning-fast customer booking widget with animated time slot calculations (<45kb bundle).

  • Floating Modal Booking

    Optional floating "Book Now" widget that integrates cleanly across any theme.

  • Revenue & Capacity Analytics

    Track projected revenue, utilization rates, and booking status breakdowns.

  • AI / MCP Integration

    Native Model Context Protocol (MCP) endpoints allow AI assistants to check schedules and book appointments.

Technical Specifications

Frontend Engine Modern React / Preact booking widget (<45kb bundle)
Sync Engine Google Calendar API v3 bidirectional webhook synchronization
AI Support Model Context Protocol (MCP) scheduling endpoints
Database wp_kairos_appointments, wp_kairos_providers, wp_kairos_services, wp_kairos_customers
Architecture Strict PSR-4 autoloading, object-oriented design

Developer Integration

// Shortcode: Embed booking engine
[kairos_booking provider="default" service="haircut"]

// MCP Agent Query: Check availability via REST endpoint
POST /wp-json/kairos/v1/availability
{"provider_id": 2, "date": "2026-10-15"}
WP-CLI: $ wp kairos list-appointments --date=today

Deployment Notes

Custom database tables completely decouple high-frequency appointment booking from wp_posts and wp_postmeta, protecting overall database query throughput.