Smart Planner AI

Permanently deletes the identified shared task, subtasks, and its history. The API restricts deletion to the creator or space owner. Confirm the target before deletion. Effects: Deletes shared task content, subtasks, and history; restricted to the creator or space owner.

delete_shared_task

Deletes a block from the Smart Planner calendar. Effects: Deletes a schedule block, clears pending reminders, and can delete its Google Calendar event.

delete_schedule_block

Deletes a subtask. Effects: Deletes an owned subtask.

delete_subtask

Deletes a task. Effects: Deletes an owned task and linked first-party records, and clears pending notifications.

delete_task

Returns the Smart Planner profile for the authenticated user. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_profile

Reads personal completion, pending/missed work, subtasks, focus time, and trends for a requested range. Uses stored data and does not create an AI run. Read preferences for the user's time zone and week start; never infer totals from only one task page. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_personal_analytics

Gets planning and notification preferences for the authenticated user. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_preferences

For local-time planning, pass timeZone from get_preferences, fromLocal/toLocal and localCandidateSlots unchanged, without Z/offset; the server resolves date-specific offsets. Never manually convert local clocks to UTC. Reads privacy-safe busy slots including personal/shared recurrences for one current member (at most 42 days). Check EVERY occurrence for EACH assignee's own availability. startLocal/endLocal already use the zone: display directly, never convert them again. Require coverageComplete and allCandidatesAvailable; follow planningStatus/nextStep. Missing duration needs a question, not an Approve/save offer. Ambiguous/nonexistent local times need clarification. No private titles, writes, or sync. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_shared_member_availability

Gets one Shared Space and its current members without loading every task. Read this before assigning or reassigning work so member IDs are never guessed. Use list_shared_tasks for paginated tasks and get_shared_task for details. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_shared_space

Reads group totals, member workload, overdue tasks, actual completion actors, and daily completion series from the API. Optionally select one current member. Group totals remain group totals; member filters apply only to the member list. The API supplies the available history window; do not invent longer trends or equate assigned completions with actions recorded by a member. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_shared_space_analytics

Reads one task and its stable subtask IDs in an accessible Shared Space. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_shared_task

Reads recorded creation, assignment, completion, and reopening activity. Attribute actions to their recorded actor, not automatically to the assignee. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_shared_task_activity

Gets one Smart Planner calendar block by ID. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_schedule_block

Gets one task by ID. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

get_task

Removes the current user's membership, unassigns their tasks, and loses access. Owners cannot leave; do not delete the space automatically if this fails. Effects: Deletes the current user's membership and unassigns their tasks, changing assignments visible to remaining members.

leave_shared_space

Lists the Shared Spaces the authenticated user belongs to, including their role, member count, and open-task count. Use this before acting on a shared plan when the user has not supplied a space ID. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

list_shared_spaces

Lists one page of tasks in a space. Follow pagination for a complete workload. Open includes all unfinished work; All follows the site's active/scheduled view and is not an archive. Today/Yesterday include day-specific statuses; use Completed, Missed, Cancelled, or Unscheduled as needed. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

list_shared_tasks

For local-time planning, pass timeZone from get_preferences, fromLocal/toLocal and localCandidateSlots unchanged, without Z/offset; the server resolves date-specific offsets. Never manually convert local clocks to UTC. Reads stored blocks plus planningAvailability with personal/shared recurrences and stored external events (at most 42 days). Empty items does NOT mean free time. Check EVERY occurrence. startLocal/endLocal already use the zone: display directly, never convert them again. Require coverageComplete and allCandidatesAvailable; follow planningStatus/nextStep. Missing duration needs a question, not an Approve/save offer. Ambiguous/nonexistent local times need clarification. Projected intervals have no writable IDs. Check freshness with get_calendar_connection_status. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

list_schedule_blocks

Lists subtasks for a task. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

list_subtasks

Lists tasks for the authenticated Smart Planner user. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

list_tasks

Reads already-synced external calendar events from Smart Planner for a time range; does not trigger synchronization or query Google directly. Check get_calendar_connection_status first and report missing/error/stale context. Premium access may be required; do not treat a denied read as an empty calendar. Use only for a user-requested Smart Planner workflow. Do not read private planning data as background context for an unrelated request, even when this app is selected or the request mentions a date or person.

list_external_calendar_events

Revokes a member's access and unassigns their shared tasks. Owner-only; the owner cannot be removed. Confirm the member and consequences before removal. Effects: Deletes membership, revokes access, and unassigns that member's shared tasks while recording assignment activity; owner-only.

remove_shared_space_member

Renames a Shared Space for all its members. Only the owner can do this. Effects: Overwrites the space name visible to all members; only its owner is authorized.

update_shared_space

Atomically saves a complete plan into one Shared Space after the user has reviewed the tasks and assignments. Use get_shared_space first, use only current member IDs, prefer recurrence over duplicate tasks, and call this once for the approved shared plan. Effects: Creates a batch of shared tasks, subtasks, assignments, and activity, and notifies eligible assignees. Delivered messages cannot be unsent. Requires approval of the complete plan; there is no batch idempotency key.

save_shared_plan

Atomically saves a complete plan authored by ChatGPT, including recurrence, subtasks, due dates, durations, and linked Smart Planner schedule blocks. Call this exactly once only after showing the complete plan in the conversation and receiving explicit user approval. Do not use Smart Planner's built-in AI first. Reuse the same requestId if the call is retried; a successful first save may start the user's 7-day Pro trial. Effects: Atomically creates an approved task/subtask/schedule batch and reminders, records the planner run, and may activate an eligible first-use trial. Delivered reminders cannot be unsent; the complete plan must be approved before this call.

save_approved_plan

Updates planning and notification preferences. Omitted fields are unchanged. Effects: Overwrites preferences; a time-zone change can rebase future task/schedule times. Notification changes replan external-channel reminders.

update_preferences

Updates the content, due date, priority, or assignee of an existing shared task. Omitted fields keep their current values, including stable subtask IDs. Supplying subtasks replaces the collection; use update_shared_subtask_status for a single check/uncheck. Resolve the assignee from get_shared_space. Effects: Overwrites shared fields and may replace the subtask collection if explicitly supplied, removing old subtask IDs. Reassignment may notify the new assignee.

update_shared_task

Marks a shared task pending, in progress, completed, or cancelled for everyone in the Shared Space. Effects: Changes shared status and activity; completing a recurring task may create its next occurrence and notify other members.

update_shared_task_status

Updates a block in the Smart Planner calendar. Omitted fields keep their current values. Effects: Overwrites a schedule block, replans reminders, and can update its Google Calendar event.

update_schedule_block

Updates a subtask title or completion state. Effects: Overwrites subtask text/completion. Completing the last subtask can complete the parent and trigger recurrence and reminder scheduling.

update_subtask

Updates a task. Omitted fields keep their current values. Effects: Overwrites selected task fields, updates linked schedule blocks, replans reminders, and may advance recurrence on completion.

update_task

Updates only a task status. Effects: Overwrites task status, updates schedules, clears or schedules reminders, and can create the next recurring occurrence.

update_task_status