Reference data & utilities
The MCP integration is in preview - tools, parameters, and behavior may change between releases.
These tools support the others. They give the assistant a way to enumerate master data (categories, time markers) and to translate human-friendly date phrases into concrete ranges.
List categories
Tool: list_categories
Returns all categories defined in the system. Useful when the assistant needs to suggest a categoryName for a create_appointment call, or to filter searches.
This tool takes no parameters.
Example prompt
"List all categories."
List time markers
Tool: list_time_markers
Returns all time markers defined in the system (e.g. Travel, Break).
This tool takes no parameters.
Example prompt
"List all time markers."
Parse relative time
Tool: parse_relative_time
Converts a natural-language relative time expression ("this week", "5 days ago", "in 3 months") into concrete UTC and local-time ranges. Use this before calling tools that take an explicit startDateTime / endDateTime whenever the user phrases a date relatively.
| Parameter | Type | Required | Description |
|---|---|---|---|
expression | string | Yes | Natural-language expression to parse (e.g. this week, next month, 5 days ago) |
timeZone | string | Yes | IANA timezone identifier |
referenceTime | string | No | Reference time in ISO 8601 (defaults to the current time in the specified time zone) |
Supported expressions
this week,next week,last week(Monday → Sunday)this month,next month,last monththis year,next year,last yeartoday,tomorrow,yesterday- Numeric offsets:
5 days ago,2 weeks from now,in 3 months, …
The parser uses Monday as the first day of the week, regardless of locale. If your assistant is built for a Sunday-start locale, account for the off-by-one.
Example prompt
"Parse 'next week' in Europe/Brussels timezone."