Make Human Time Resolvable

Calendario is an open protocol to declare and discover availability across the internet.

Explore Spec Submit Profile (Coming Soon)

What Is Calendario?

Calendario is a decentralized, federated protocol that lets anyone publish their availability, preferences, pricing, and booking endpoints via a simple .well-known JSON file. Think of it as a DNS for time — declarative, resolvable, and universally linkable.

When you're available

How booking requests can be submitted

What it costs, and how to pay

Where to confirm availability

Why It Matters

How It Works

Host a JSON file at: https://yourdomain.com/.well-known/calendario/yourname.json

Sample JSON (v0.1)

{
  "version": "0.1",
  "username": "jane",
  "display_name": "Jane Doe",
  "timezone": "America/New_York",
  "min_notice_hours": 72,
  "max_bookings_per_day": 3,
  "blackouts": [
    "2025-12-01",
    { "start": "2025-12-24", "end": "2025-12-31" }
  ],
  "scheduling": [
    {
      "type": "weekly",
      "days": ["monday", "wednesday", "friday"],
      "hours": ["09:00-11:00", "16:00-18:00"],
      "expires": "2025-06-30"
    }
  ],
  "visibility": "public",
  "allow_anonymous_booking": false,
  "meeting_response_url": "https://yourdomain.com/api/bookings/jane",
  "static_meeting_url": "https://meet.google.com/abc-defg-hij",
  "free_busy_url": "https://yourdomain.com/api/freebusy/jane",
  "pricing": {
    "hour": 75,
    "half_hour": 45,
    "currency": "USD"
  },
  "payment_required": true,
  "payment_url": "https://yourdomain.com/pay/jane",
  "confirmation_message": "Thank you for booking with Jane. Please bring your brief and join the call 5 mins early.",
  "no_show_policy_url": "https://yourdomain.com/no-show",
  "terms_url": "https://yourdomain.com/terms",
  "privacy_url": "https://yourdomain.com/privacy"
}

Who It’s For