FabricLoop: Tasks, Chat, Notes

Update a comment's contentMarkup (and optional referencedUsers) by commentID.

Rename, change privacy/default, or update members of an existing group. Call query_workspace first to find the group ID.

Update an existing news post. Call query_workspace to find the news ID first.

Update 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.

Update 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 a short-lived signed download URL for a file or storage path (expires in ~15 minutes). Provide fileID or url.

List comments on a task, news post, or note. Provide exactly one of taskID, newsID, or noteID. The response includes total and returned: for counts use total, never the length of the comments array, and when truncated is true say the list is partial.

Read 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.

Read 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.

Retrieve 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 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.

Retrieve 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 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 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.

Look 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 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 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 owned by the current user (messages and comments). Optional filter by draftEntityType.

List the current user's pending scheduled (send-later) messages.

List workspaces the authenticated user belongs to (id, name, role). Does not switch the active workspace.

Download 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.

Change sendAt on a scheduled message owned by the current user.

Schedule a message to send later (text only via MCP). Provide recipientUserIDs and/or conversationID, text, and future sendAt (ISO datetime).

Search 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.

Post a message. For an existing channel or DM, pass conversationID (and optional parentMessageID to thread). recipientUserIDs opens or uses a DM with those people.

Immediately send a scheduled message (promotes it to a live message and removes it from the schedule).

Create 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.