Calendar and events · API reference

Query parameters

company_iduuidoptional
Company UUID (optional; otherwise the whole organisation).
limitintegeroptional
Maximum number of entries (default 30).

Response

Status 200, application/json. Resources outside your rights are absent, never an error.

entriesobject[]
Show child attributes
- datestring · nullable
- kindstring
  activity | event
- typestring · nullable
- titlestring · nullable
- locationstring · nullable

Errors

400 invalid parameter · 401 missing or expired token · 429 too many requests · 500 read failed. See Errors.

Request

cURL

curl "https://jolv-mcp.vercel.app/v1/get_calendar" \
  -H "Authorization: Bearer $JOLV_TOKEN"

Python

import os, requests

r = requests.get(
    "https://jolv-mcp.vercel.app/v1/get_calendar",
    headers={"Authorization": f"Bearer {os.environ['JOLV_TOKEN']}"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

JavaScript

const r = await fetch("https://jolv-mcp.vercel.app/v1/get_calendar", {
  headers: { Authorization: `Bearer ${process.env.JOLV_TOKEN}` },
});
if (!r.ok) throw new Error((await r.json()).error.message);
const data = await r.json();

Power Query

let
    Source = Json.Document(Web.Contents(
        "https://jolv-mcp.vercel.app/v1/get_calendar",
        [Headers = [Authorization = "Bearer <access_token>"]]))
in
    Source

Example response (illustrative values)

200

{
  "entries": [
    {
      "date": "2026-03-12",
      "kind": "event",
      "type": "board_meeting",
      "title": "Nordlicht Software – Q1 board",
      "location": "Berlin"
    },
    {
      "date": "2026-03-26",
      "kind": "activity",
      "type": "call",
      "title": "Aurel Santé – budget review call",
      "location": "Video call"
    },
    {
      "date": "2026-04-15",
      "kind": "event",
      "type": "lp_reporting",
      "title": "Buyout I – Q1 2026 LP report due",
      "location": "Paris"
    }
  ]
}

Try it

or paste a token below

The call goes from your browser to the API with your own token; nothing is stored. Token kept in this tab only.