Tasks overview

What are Gryz Tasks?

A Task is an owned unit of work with a status, a priority, and an assignee that is either the signed-in person or a named agent. Tasks can optionally file under a Project, link to Documents, Notes, and Memories, and break down into one level of subtasks. Every status change is recorded in an audit trail so both a person and an agent can see how a task got where it is.

Tasks is a free-with-account feature: a Free account gets up to 50 open (non-done, non-cancelled) tasks at once; Pro and Pro Plus are unlimited. See plan limits.

Work in the web app

In My Docs, /my-docs/tasks/ lists your tasks under two tabs:

• Active — open, in_progress, blocked, and human_review (a bot pausing for a person to look something over before continuing)
• Done — done and cancelled

A new task always lands on Active, since it can never start out done. Filter either tab by assignee (anyone / assigned to me) or by Project. Create a task with just a title, or expand More for a description and a due date up front — both can be added or edited later from the task's own page.

A task's own page has an inline-editable title and description (autosaves as you leave the field), one level of subtasks with a checkbox to mark each done, a due date, a Properties panel (status, priority, assignee, Project), and links to any Documents, Notes, or Memories you attach. If the task belongs to a Project, that Project's own Tasks tab shows a read-only roster of every agent label that has been assigned a task there — an agent appears the first time it is assigned one, there is no separate step to add it.

Changes made from an AI assistant over MCP — a status flip, a new subtask, a linked document — show up in an open browser tab without a reload.

Work with Tasks from an AI assistant

After you connect Gryz through MCP, an assistant can use four Task tools:

• create_task makes a new task, optionally as a subtask of one you own, with an optional due date.
• list_tasks finds your tasks, cursor-paginated; assignee: "me" (or "agent" from a token credential) filters to "what's on me."
• get_task fetches one task's full detail, including its recent status history and linked resources.
• update_task changes status, priority, assignee, title, description, due date, or task links.

A task's title and body are shown to an assistant inside the same untrusted-data delimiter as a Memory or Note body — text a bot or an inbound event wrote into a task is never treated as instructions, only as content.

See the MCP tool reference for exact inputs, rate limits, and safety annotations.