My Calendar
The signed-in user's own personal calendar, separate from any project: personal calendars and events, and an agenda that puts them together with the calendars of the projects the user owns (today or the next days, in the user's time zone). Use agenda for "what is on my day / week"; use upsert-event to add or change an appointment. Every signed-in user has it, free; only the user can see it. Stored datetimes are UTC: send times with an offset (2026-11-20T09:00:00+01:00) or in UTC. An all-day event runs from its date to the next day (end_at = the day after).
Try it with your AI assistant
Once WebsitePublisher is connected to your AI assistant, paste one of these into the chat. Replace the parts in [brackets] with your own details.
@WebsitePublisher what is on my agenda today?@WebsitePublisher put [dentist] in my calendar on [Friday at 9:00] for [30] minutes@WebsitePublisher give me an overview of my week, including my project bookingsWith WebsitePublisher, what is on my agenda today?With WebsitePublisher, put [dentist] in my calendar on [Friday at 9:00] for [30] minutesWith WebsitePublisher, give me an overview of my week, including my project bookingsWith WebsitePublisher, what is on my agenda today?With WebsitePublisher, put [dentist] in my calendar on [Friday at 9:00] for [30] minutesWith WebsitePublisher, give me an overview of my week, including my project bookingsEndpoints (8)
The user's agenda for whole local days: personal events plus the events of the projects the user owns, sorted by start, with start_local / end_local in the requested time zone. Default: today and the next 6 days.
| Field | Type | Required | Description |
|---|---|---|---|
from_date |
string | No | First day, YYYY-MM-DD in the time zone below. Default: today there. |
days |
integer | No | Number of days, 1 to 31 (default 7). 1 = only from_date. |
timezone |
string | No | IANA time zone for the days and the local times (default Europe/Amsterdam). |
include_projects |
boolean | No | Add the calendars of the projects the user owns (default true). |
include_cancelled |
boolean | No | Also list cancelled events (default false). |
The user's personal calendars.
No input parameters required.
Create or update a personal calendar. Without calendar_id = create (name required), with calendar_id = update. At most 20 per user.
| Field | Type | Required | Description |
|---|---|---|---|
calendar_id |
integer | No | ID of one of the user's calendars (omit when creating). |
name |
string | No | Calendar name. Required when creating. |
timezone |
string | No | IANA time zone for display (default Europe/Amsterdam). Storage stays UTC. |
color |
string | No | Hex color for the UI, e.g. #1B4332. Empty clears it. |
Delete one of the user's calendars including all its events.
| Field | Type | Required | Description |
|---|---|---|---|
calendar_id |
integer | ✓ Yes | ID of the calendar to delete. |
Personal events that overlap the window [from, to) (at most 400 days), all of the user's calendars or one. Includes cancelled events.
| Field | Type | Required | Description |
|---|---|---|---|
from |
string | ✓ Yes | Window start (UTC, or with an offset). |
to |
string | ✓ Yes | Window end (UTC, or with an offset). |
calendar_id |
integer | No | Only this calendar. |
Create or update a personal event. Without event_id = create (calendar_id, title, start_at, end_at required). Times without an offset are read as UTC.
| Field | Type | Required | Description |
|---|---|---|---|
event_id |
integer | No | ID of an existing event (omit when creating). |
calendar_id |
integer | No | One of the user's calendars. Required when creating; on update it moves the event. |
title |
string | No | Title. Required when creating. |
description |
string | No | Notes. |
location |
string | No | Location. |
start_at |
string | No | Start, e.g. 2026-11-20T09:00:00+01:00. For an all-day event the date. Required when creating. |
end_at |
string | No | End, after start_at. For an all-day event the day after. Required when creating. |
all_day |
boolean | No | All-day event. |
status |
string | No | confirmed | tentative | cancelled (default confirmed). |
Delete one of the user's events.
| Field | Type | Required | Description |
|---|---|---|---|
event_id |
integer | ✓ Yes | ID of the event to delete. |
Private ICS link of one personal calendar, to subscribe to it in Apple Calendar, Google Calendar or Outlook. Anyone with the link can read the calendar; rotate=true replaces it and the old link stops working.
| Field | Type | Required | Description |
|---|---|---|---|
calendar_id |
integer | ✓ Yes | ID of the calendar. |
rotate |
boolean | No | Replace the link (default false). |
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| agenda | my_calendar_agenda |
| list-calendars | my_calendar_list_calendars |
| upsert-calendar | my_calendar_upsert_calendar |
| delete-calendar | my_calendar_delete_calendar |
| list-events | my_calendar_list_events |
| upsert-event | my_calendar_upsert_event |
| delete-event | my_calendar_delete_event |
| get-feed-url | my_calendar_get_feed_url |
Website