approve_note
ChatGPTApprove a note that is waiting for your approval: you are one of its assignees and have not approved it yet. Adds you to the note's approvers, the same as tapping Approve in the app. Find the note ID with get_notes. Tell the user which note you are approving and get a clear yes first.
cancel_scheduled_message
ChatGPTCancel (soft-delete) a scheduled message owned by the current user.
complete_attachment_upload
ChatGPTAfter PUTing bytes to the signed URL from create_attachment_upload, insert the files row so the file appears on the task. Pass the path (or fileURL) returned by create_attachment_upload.
create_attachment_upload
ChatGPTPrepare a task file attachment. Returns a short-lived signed PUT URL. Do not send file bytes through this tool — PUT the local file to uploadUrl, then call complete_attachment_upload. Max 50MB.
create_document
ChatGPTCreate a Word (.docx), Excel (.xlsx), PDF (.pdf) or PowerPoint (.pptx) file. Pass taskID to attach it to a task; leave taskID out to make a standalone file that only the user who asked for it can see (they can attach it to a task later). Use for reports, briefs, exports and tables the user wants as a real file. Pass structured content, never raw file bytes. For type "docx" or "pdf", content is {"title"?: string, "blocks": [...]} where each block is one of: {"type":"heading","level":1|2|3,"text":string}, {"type":"paragraph","text":string} (or "runs":[{"text":string,"bold"?:bool,"italic"?:bool}]), {"type":"bullets","items":[string]}, {"type":"numbered","items":[string]}, {"type":"table","header"?:[string],"rows":[[string|number]]}. For type "xlsx", content is {"sheets":[{"name":string,"columns":[string],"rows":[[string|number|boolean|null|{"formula":string}]],"freezeHeader"?:bool,"formats"?:["text"|"integer"|"decimal"|"currency"|"percent"]}]} where formats has one entry per column (percent expects a fraction such as 0.15). Numbers are formatted automatically when formats is omitted. For type "pptx", content is {"title"?:string,"accent"?:"#RRGGBB","slides":[...]}. Every slide has a "layout" and a "title" (optional "notes" for speaker notes): {"layout":"title","title":string,"subtitle"?:string}, {"layout":"section","title":string,"subtitle"?:string}, {"layout":"bullets","title":string,"bullets":[string]}, {"layout":"two_column","title":string,"left":{"heading"?:string,"bullets":[string]},"right":{"heading"?:string,"bullets":[string]}}, {"layout":"table","title":string,"header"?:[string],"rows":[[string]]}, {"layout":"chart","title":string,"chart":{"type":"bar"|"line"|"pie","labels":[string],"series":[{"name":string,"values":[number]}],"editable"?:bool}} (a pie chart takes one series of non-negative numbers). Charts are drawn so every viewer shows them; set "editable" true only if the user wants to edit the chart data in PowerPoint, because some previews leave editable charts blank. Keep slide text short and split long content across slides. Limits: 60 slides, 12 bullets, 14 table rows and 8 columns, 24 chart labels and 4 series per slide. PDF text is Latin-script only: other scripts and emoji print as "?"; use docx for those. Text cells are always literal text; use {"formula":"SUM(B2:B10)"} for calculations (no external references). Limits: docx 200 blocks and 500 table rows; xlsx 10 sheets, 5000 rows and 50 columns per sheet.
create_group
ChatGPTCreate a new group (tag) in the workspace. Groups are used to organise tasks, notes, news, and messages. Creator is always a member. When isPrivate is true, pass allowedUsersIDs. When isDefault is true (public only), all workspace members are joined.
create_news
ChatGPTPost a news item to the workspace feed. Can include event date/time.
create_note
ChatGPTCreate a new collaborative note in the workspace.
create_tasks
ChatGPTCreate one or more tasks in the workspace (max 20 tasks per call). Use when the user asks to add, create, or schedule tasks. To assign people, set each task's "assignee" to an array of workspace user UUIDs (e.g. "assignee":["<uuid>"]). Do not use assigneeId or assignees. To add subtasks, create the parent first, then call again with parentTaskID set to that task. parentTaskID must already exist, so it cannot refer to another task in the same call.
delete_draft
ChatGPTDelete a draft owned by the current user.
edit_group
ChatGPTRename, change privacy/default, or update members of an existing group. Call query_workspace first to find the group ID.
edit_news
ChatGPTUpdate an existing news post. Call query_workspace to find the news ID first.
edit_note
ChatGPTUpdate a note. To add a paragraph or section, pass append (TipTap JSON of only the new blocks) so the existing body and its formatting stay. Pass content only when the user explicitly wants the whole body replaced. Find the note ID via get_notes first.
edit_task
ChatGPTUpdate fields of an existing task. taskID accepts the task UUID or its code (e.g. FL-142); if you have neither, call get_tasks or search_workspace first. To mark a task done/complete/finished: set done:true (the tool also moves it into the Done section and sets progress). Setting only taskSectionID to the Done column also marks it done. To reopen: set done:false (moves it out of Done) or move taskSectionID to a non-Done section. parentTaskID sets or clears the parent (null detaches). labels replaces the task's labels (omit to leave them, [] clears them). A parent with open subtasks has its progress computed by the database (average of the children, capped at 0.99) unless done is true.
get_attachment_url
ChatGPTGet a short-lived signed download URL for a file or storage path (expires in ~15 minutes). Provide fileID or url.
get_messages
ChatGPTRead messages in a conversation the user participates in (including 1:1 DMs). Returns plainText, authorID, timestamps (not raw file binaries). Filter by createdAt for "today"/date ranges yourself. Page older with before. Do not dump full history unless the user asked.
get_note_body
ChatGPTRead the plain text of one note the caller can see, capped at 12,000 characters. Use this when the note is not open on screen. get_notes does not return bodies.
get_notes
ChatGPTRetrieve notes in the workspace. Use this to find a note by title or list existing notes before editing. Always call this before edit_note if the user references a note by name. The response includes total and returned: for counts use total, never the length of the notes array, and when truncated is true say the list is partial.
get_task_sections
ChatGPTGet all task sections (columns) in the workspace with their IDs and names (e.g. Backlog, To-do, In Progress, Done). Use this to resolve a section name to an ID for create_tasks or edit_task. For "mark done" / "complete the task", prefer edit_task with done:true (Done section is applied automatically); use this tool when the user asks to move a task into a named column.
get_tasks
ChatGPTRetrieve tasks in the workspace. CRITICAL: when the user asks for tasks assigned to them or named people, you MUST filter with assignee_id / assignee_ids — never return an unfiltered workspace dump for those requests. When they ask for tasks they (or someone) created / own / assigned to others, filter with assigned_by / assigned_by_ids (the creator), not assignee. Also set done appropriately (false = open/incomplete, true = completed, omit = all). The response includes total (how many tasks match the filter) and returned (how many are in this page). For counts, always use total, never the length of the tasks array. When truncated is true you are seeing a partial list: say so rather than presenting the page as the complete set.
get_workspace_groups
ChatGPTGet all groups (tags) in the workspace with their IDs and names. Use this whenever you need a tag/group UUID for task, note, or news fields.
get_workspace_labels
ChatGPTGet task label sets and their labels for this workspace (for example Type, which allows one label, and Labels, which allows several). Use the label UUIDs on create_tasks and edit_task. These are task labels, not groups — groups come from get_workspace_groups. hiddenForGroupIDs lists groups for which the app hides that set; do not apply a set the task's groups hide.
get_workspace_users
ChatGPTLook up workspace users (id + name). ALWAYS pass query/name when resolving a person (e.g. query:"Phoenix") — the workspace can have hundreds of members and unfiltered lists are truncated. Matching is case-insensitive and matches partial names (phoenix, Phoenix Damani). Use the returned UUID for assignee / send_message. Never invent user IDs.
list_attachments
ChatGPTList attachments for a task or news item. Provide taskID and/or newsID. For notes, TipTap-embedded media is not listed here — use get_notes / note content instead.
list_conversations
ChatGPTList the current user's chats (DMs and group chats), most recently updated first. Returns id, participantDetails (id + name), last message preview, and updatedAt. Optional query filters chats whose participant names match (e.g. query:"Rodrigo"). To find a fact in messages, call search_workspace. To read one thread in order, call get_messages.
list_drafts
ChatGPTList drafts owned by the current user (messages and comments). Optional filter by draftEntityType.
list_scheduled_messages
ChatGPTList the current user's pending scheduled (send-later) messages.
list_workspaces
ChatGPTList workspaces the authenticated user belongs to (id, name, role). Does not switch the active workspace.
read_attachment_text
ChatGPTDownload and extract text from a PDF or text/* attachment (max 2MB input, text truncated to 100k chars). Provide fileID or url. For images/video use get_attachment_url instead.
reschedule_message
ChatGPTChange sendAt on a scheduled message owned by the current user.
schedule_message
ChatGPTSchedule a message to send later (text only via MCP). Provide recipientUserIDs and/or conversationID, text, and future sendAt (ISO datetime).
search_workspace
ChatGPTSearch tasks, notes, news, messages, files, comments, and calls this person can see. Use it when a saved summary does not contain the fact, or to find where something was said. Returns short snippets, not a full thread — call get_messages, get_tasks, or get_note_body to read more. Do NOT use this to look up user IDs — use get_workspace_users. This does NOT search the public web.
send_message
ChatGPTPost a message. For an existing channel or DM, pass conversationID (and optional parentMessageID to thread). recipientUserIDs opens or uses a DM with those people.
send_scheduled_now
ChatGPTImmediately send a scheduled message (promotes it to a live message and removes it from the schedule).
upsert_draft
ChatGPTCreate or update a text draft for the current user. For comment drafts, entityID is the parent task/note/news UUID (or scoped draft id). For conversation drafts, entityID is the conversation UUID.