add_shared_space_member
ChatGPTImmediately grants an existing registered account access to this space and notifies them in-app. Owner-only; this is not a pending email invitation. Confirm the user-specified email and sharing intent first. If the account does not exist, report the error rather than inventing an invitation. Effects: Immediately grants an existing registered user access and sends an in-app notification. Previously viewed shared content cannot be made unseen by revoking access later; owner-only and only with explicit sharing intent.
create_schedule_block
ChatGPTCreates a placement in the Smart Planner calendar. If taskId is omitted, Smart Planner creates and links a task for the scheduled item. Effects: Creates a schedule block, schedules reminders, and can create a corresponding Google Calendar event. Delivered reminders cannot be unsent; create only a user-requested block.
create_shared_space
ChatGPTCreates a named space owned by the current user. Does not add other members. Call only when the user asks to create it. Effects: Creates a space with only the current user as owner. Does not add or notify anyone else.
create_shared_task
ChatGPTCreates one task in a Shared Space and can assign it to a current member. Use get_shared_space first and only pass an assigneeUserId returned in that space's members list. This notifies the assignee inside Smart Planner. Effects: Creates shared content and optional subtasks/recurrence; an assigned member may receive in-app and push notifications that cannot be unsent. Requires the user's assignment request.
create_subtask
ChatGPTCreates a subtask for a task. Effects: Creates a subtask and can shift existing subtask sort positions; no existing content is removed.
create_task
ChatGPTCreates one specific task requested by the user. Do not call this repeatedly to save a plan drafted by ChatGPT; show the complete draft, get explicit approval, then call save_approved_plan once. Effects: Creates a task, linked schedule blocks when applicable, and pending reminders. Delivered external-channel reminders cannot be unsent; only create tasks the user requested.
delete_schedule_block
ChatGPTDeletes a block from the Smart Planner calendar. Effects: Deletes a schedule block, clears pending reminders, and can delete its Google Calendar event.
delete_shared_space
ChatGPTPermanently deletes a space and its shared content for everyone. Owner-only. Confirm the exact space and this consequence before deletion; never use this as a substitute for leaving. Effects: Deletes the space and its shared content for all members; owner-only.
delete_shared_task
ChatGPTPermanently 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_subtask
ChatGPTDeletes a subtask. Effects: Deletes an owned subtask.
delete_task
ChatGPTDeletes a task. Effects: Deletes an owned task and linked first-party records, and clears pending notifications.
get_calendar_connection_status
ChatGPTChecks whether an external calendar is connected and usable inside Smart Planner. Always call this before a planning request that mentions the Smart Planner calendar or synced events. If the calendar is not connected or needs reconnection, explicitly tell the user that external events were not considered and direct them to Smart Planner Settings before drafting a calendar-aware plan. 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
ChatGPTReads 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_preferences
ChatGPTGets 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_profile
ChatGPTReturns 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_schedule_block
ChatGPTGets 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_shared_member_availability
ChatGPTFor 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_space
ChatGPTGets 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_analytics
ChatGPTReads 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_task
ChatGPTReads 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_activity
ChatGPTReads 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_task
ChatGPTGets 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.
leave_shared_space
ChatGPTRemoves 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.
list_external_calendar_events
ChatGPTReads 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_schedule_blocks
ChatGPTFor 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_shared_spaces
ChatGPTLists 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_tasks
ChatGPTLists 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_subtasks
ChatGPTLists 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_tasks
ChatGPTLists 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.
remove_shared_space_member
ChatGPTRevokes 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.
save_approved_plan
ChatGPTAtomically 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_shared_plan
ChatGPTAtomically 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.
smart_planner_health
ChatGPTChecks whether the configured Smart Planner API is reachable.
update_preferences
ChatGPTUpdates 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_schedule_block
ChatGPTUpdates 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_shared_space
ChatGPTRenames 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_subtask_status
ChatGPTSets one existing subtask's completion without replacing other subtasks. Completing the last unfinished subtask can complete its parent, create the next recurring occurrence, and notify members. Unchecking alone does not reopen the parent; only reopen it if the user requests that too. Effects: Overwrites a subtask completion flag; completing the last subtask may complete its parent, advance recurrence, and notify members.
update_shared_task
ChatGPTUpdates 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_status
ChatGPTMarks 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_subtask
ChatGPTUpdates 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_task
ChatGPTUpdates 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_status
ChatGPTUpdates only a task status. Effects: Overwrites task status, updates schedules, clears or schedules reminders, and can create the next recurring occurrence.
