Calendar bot in Telegram messenger With MCP you can create events/reminders, get your schedule, notes, plans etc
Scored across 19 tools
Most tools target a distinct resource+action pair, and descriptions clarify render-only tools versus read tools (render_event vs get_event) and conflict discovery versus free-slot search. The main overlap is set_event_status versus update_event, since status is also an updatable field, and save_flow/delete_flow versus the flow getter could momentarily confuse. Still, boundaries are largely clear.
All 19 tools follow a consistent snake_case verb_noun pattern (create_event, get_event, search_events, list_calendars, save_note, delete_flow, get_holidays). Even closely related pairs use predictable verb variants (get/save/delete for flows, get/list for holidays). No camelCase or mixed conventions appear.
Nineteen tools across five sub-domains (events, notes, cycle flows, holidays, rendering/profile) is slightly heavy but each tool maps to a real operation. Nothing looks redundant enough to be padding. A marginally tighter surface could merge profile/holiday lookups, but the count is reasonable.
Event lifecycle is fully covered (create/get/update/delete/status/search/conflicts/free slots) and notes and flows have working get/save/delete paths. Gaps are modest: calendars can be listed but not created or edited, and profile is read-only. These are workable limitations rather than dead ends for the core scheduling use case.
Create an event or task for the authenticated user. title is required (1–200 characters). start and end are ISO 8601 date-time with offset, or YYYY-MM-DD for an all-day event in the event timezone. timezone is an IANA name (default UTC) and stays the event zone: it is not replaced by the user timezone. rrule is an iCalendar RRULE string. status is active, done, undone, or cancelled. type is event or task. location is a short place name. waitSync defaults to true and waits for the external calendar so the response can include links; false responds immediately and links may be absent.
Inputs: title (required), end, desc, type, +8 more. Returns: id, end, desc, type, +11 more
Delete an event owned by the authenticated user. mode all removes the whole series (default). occurrence removes one date; following removes that date and later ones. occurrence and following require occurrenceDate as ISO 8601 date or date-time. A missing id and an id owned by someone else both return not found.
Inputs: id (required), mode, occurrenceDate. Returns: ok
Delete a menstrual-cycle start or end mark for the authenticated user. date is YYYY-MM-DD. event is flowstart or flowend.
Inputs: date (required), event (required). Returns: ok
Find overlapping events in the authenticated user calendar. from and to are optional ISO 8601 date or date-time (default ±31 days). The window cannot exceed 366 days. Optional start and end check a proposed slot against existing events before create_event. Optional calendarId limits the search to one calendar. Intervals that only touch at an endpoint are not a conflict.
Inputs: to, end, from, start, +1 more. Returns: conflicts
Get one event owned by the authenticated user by id. A missing id and an id owned by someone else both return not found. Dates use the user timezone.
Inputs: id (required). Returns: id, end, desc, type, +11 more
Get menstrual-cycle periods, settings, and history for the authenticated user. Period bounds use the user timezone. Dates in history are YYYY-MM-DD. Does not include cycle-share links or secrets.
Inputs: no named parameters. Returns: opts, history, periods
Find unoccupied time windows in the authenticated user calendar. from and to are optional ISO 8601 date or date-time (default ±31 days). The window cannot exceed 366 days. duration is the minimum slot length in minutes (default 30, range 5–1440). Optional dayStart and dayEnd limit the search to a workday in HH:MM (24-hour, user timezone). Slot bounds use the user timezone.
Inputs: to, from, dayEnd, dayStart, +1 more. Returns: slots
Get public holidays for a country and year. country is a code from list_holiday_countries. lang is optional (defaults to the user locale, then en). year is optional (defaults to the current year). Dates in the result are YYYY-MM-DD.
Inputs: country (required), lang, year. Returns: object
Profile of the authenticated user: id, name, username, timezone, locale. The timezone field is the IANA zone in which every date in this API is returned (ISO 8601 with that offset). Full settings are never returned.
Inputs: no named parameters. Returns: id, locale, lastname, timezone, +2 more
List daily notes of the authenticated user in a time window. from and to are optional ISO 8601 date or date-time (default ±31 days). The window cannot exceed 366 days. Dates in the result are YYYY-MM-DD.
Inputs: to, from. Returns: notes
List calendars owned by the authenticated user. Returns id, name, description, image id, and whether the calendar is shared. Does not include calendars of other users.
Inputs: no named parameters. Returns: calendars
List country codes that have public-holiday data. Use a code as country in get_holidays.
Inputs: no named parameters. Returns: countries
Show a week or month agenda in the chat. First call search_events with the same from and to, then pass view plus that window and events here. This tool only renders; it does not read the calendar store.
Inputs: to (required), from (required), view (required), events (required), +1 more. Returns: to, from, view, events, +1 more
Show an event card in the chat. First call get_event or search_events, then pass that PublicEvent here. This tool only renders; it does not read the calendar store.
Inputs: id (required), title (required), end, desc, +11 more. Returns: id, end, desc, type, +11 more
Mark a menstrual-cycle start or end for the authenticated user. date is YYYY-MM-DD. event is flowstart or flowend.
Inputs: date (required), event (required). Returns: ok
Create or replace a daily note for the authenticated user. date is YYYY-MM-DD. text is the note body (up to 1000 characters). emoji is an optional list of emoji strings. append true adds text to the existing note instead of replacing it. Clearing the text deletes the note and still returns an empty note for that date.
Inputs: date (required), text, emoji, append. Returns: date, text, emoji
List events in a time window for the authenticated user, including items from subscribed or shared calendars. from and to are optional ISO 8601 date or date-time (default ±31 days). The window cannot exceed 366 days. Optional calendarId filters one calendar; optional q matches title or description (case-insensitive). Dates in the result use the user timezone.
Inputs: q, to, from, calendarId. Returns: events
Set status of an event owned by the authenticated user. status is active, done, undone, or cancelled. For a repeating task pass occurrenceDate as ISO 8601 date or date-time so only that day changes. A missing id and an id owned by someone else both return not found.
Inputs: id (required), status (required), occurrenceDate. Returns: id, end, desc, type, +11 more
Update an event owned by the authenticated user. Pass id plus any fields to change. start and end are ISO 8601 date-time with offset, or YYYY-MM-DD for an all-day event in the event timezone. A missing id and an id owned by someone else both return not found. waitSync defaults to true and waits for the external calendar so the response can include links; false responds immediately and links may be absent.
Inputs: id (required), end, desc, type, +9 more. Returns: id, end, desc, type, +11 more
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Add one secure layer between your agents and this server.
