TimeTree MCP Server

Post a comment on an event and return it with its id. Comments are visible to everyone in the calendar; by default no push notification is sent (silent). Get event_uuid from get_events. To change the event's own note use update_event; to edit or remove a comment later use update_event_comment or delete_event_comment.

Copy an existing event to a new date and time, optionally into another calendar, and return the new event. Keeps the title, note, location, URL, label, reminders, and checklist; recurrence is not copied, so the copy is a single event. Attendees and virtual attendees are kept only within the same calendar. The original is unchanged.

Create a new, empty calendar owned by you and return its ID. Does not invite anyone or change existing calendars. Name is 1-20 characters and purpose is required. After a timeout or server error, check list_calendars before retrying, since the calendar may already exist.

Create an event in a TimeTree calendar and return it with its uuid. Other calendar members see it, and attendees may be notified. Supports all-day events, reminders, RRULE recurrence, attendees (user IDs from get_calendar_members), virtual member attendees, and a checklist. For a memo without a date use create_memo; to duplicate an existing event use copy_event.

Create a memo in a calendar and return it with its uuid: a note, list, or checklist that is not a scheduled event, such as a shopping list. Other calendar members can see it. Use create_event for something that happens at a time. Change it later with update_memo.

Add a virtual member to a calendar: someone or something without a TimeTree account, such as a child, pet, or car, so events can be assigned to it with virtual_user_attendees. Everyone in the calendar sees it. A calendar can have at most 10. Returns the new member with its id and uuid.

Delete an event, including every occurrence of a recurring event. Cannot be undone. To delete one occurrence or the ones after it, use delete_event_occurrence. For memos use delete_memo.

Delete a comment from an event. Cannot be undone, and TimeTree lets only the comment's author delete it. Get comment_id from list_event_comments.

Delete one occurrence of a recurring event, or that occurrence and all later ones (scope "this_and_following"), keeping the rest of the series. Use delete_event to delete the whole series. Get the series uuid and occurrence_start_at from get_events with start_before set. Deleting from the first occurrence onward deletes the whole series. Cannot be undone.

Delete a memo. Cannot be undone. Get memo_uuid from list_memos. Fails for regular events (use delete_event).

Remove a virtual member from a calendar. Cannot be undone. Get virtual_member_uuid from get_calendar_virtual_members (the uuid, not the id).

List the 10 color labels of a calendar with their IDs, names, colors, and order. Use the IDs as label_id when creating or filtering events; rename or recolor them with update_calendar_labels.

List the people who share a calendar (members with TimeTree accounts) with their user IDs, names, and roles. Use user_id for event attendees. For members without an account, such as children or pets, use get_calendar_virtual_members.

List the virtual members of a calendar: people or things without a TimeTree account, such as a child, pet, or car, that events can be assigned to. Returns id (for virtual_user_attendees on events) and uuid (to update or delete the member). For members with accounts use get_calendar_members.

Return the signed-in TimeTree user's user ID and name. Use it to find "me" among calendar members (get_calendar_members), event attendees, comment authors, and activity.

View one image attached to an event comment, including images posted by free accounts. Get comment_id and image_index from list_event_comments. Returns image content directly, without saving a file. Supports JPEG, PNG, GIF, and WebP up to 5 MiB. Premium event file attachments are not supported.

Find events in a calendar by start time range, keyword, or label, sorted by start time. Use this to answer "what is on my schedule"; use get_updated_events or get_recent_activity for "what changed". Reads every page of the calendar, then filters; limit applies after sorting. Memos are included unless include_memos is false (list_memos returns only memos). When start_before is set, recurring events are expanded into each occurrence in the range. Occurrences share the series uuid, so update_event changes the whole series; use update_event_occurrence or delete_event_occurrence with the occurrence start_at to change one.

Look up public holidays and observances for up to 5 countries in a date range of up to 2 years, sorted by date. day_off tells whether it is a day off. These are national holidays, not events in your calendars (use get_events for those).

See who recently created, changed, or deleted events and memos in a calendar, newest first (created, title/date/label/note/location/reminder/URL/checklist updated, deleted), with member names. TimeTree keeps only the last few activities per event, so this is a recent feed, not full history. Use get_updated_events for the current content of changed events.

List events and memos changed after a point in time, with their current content. Deleted ones are included with deleted: true. Use this to sync or review changes since a time; use get_recent_activity to see who changed what, and get_events to look up a schedule. Recurring events are returned once, not expanded.

List your active TimeTree calendars with their IDs, names, and members. Call this first: every other tool needs a calendar_id from here. Use the member names to pick a calendar when the user mentions a person (e.g., "events with [name]").

List comments with their ids, author user IDs, and attached image metadata. Use get_event_comment_image to view an image. Only comments are returned, not change history; use get_recent_activity for who changed what.

List the memos in a calendar: notes, lists, and checklists that are not scheduled events. Use get_events for events (it also includes memos unless include_memos is false). Optionally only memos updated after a time.

Rename or recolor calendar labels for everyone in the calendar, and return all labels. Only the labels you pass change; the others are read first and kept. Label IDs come from get_calendar_labels.

Change an event and return the updated event. Only provide the fields to change; array fields (attendees, alerts, recurrences, checklist, virtual attendees) replace the current values. For a recurring event this changes every occurrence; to change one occurrence or the ones after it, use update_event_occurrence. For memos use update_memo.

Replace the text of an existing comment and return it. TimeTree lets only the comment's author edit it. Get comment_id from list_event_comments; use add_event_comment to post a new comment instead.

Change one occurrence of a recurring event ("only this week"), or that occurrence and all later ones (scope "this_and_following", e.g. "from next month on"), keeping earlier occurrences as they are. Use update_event to change the whole series. Get the series uuid and occurrence_start_at from get_events with start_before set. Only provide the fields to change; start_at moves the occurrence and keeps its length unless end_at is given. scope "this" creates a separate event linked to the series (parent_id); "this_and_following" ends the series before the occurrence and starts a new series with a new uuid, or changes the whole series when it is the first occurrence.

Change a memo and return it. Only provide the fields to change; checklist and virtual attendees replace the current lists. Get memo_uuid from list_memos. Fails for regular events (use update_event).

Change a virtual member's name, type, short description, or birthday, and return it. Only provide the fields to change. Get virtual_member_uuid from get_calendar_virtual_members (the uuid, not the id).