GetItDone

Get the content of a single task: its notes, every attachment (image, video, document) with short-lived URLs the AI can fetch to read the actual content, and its dependency chain — which tasks are blocking it and which tasks it blocks. Use this after list_tasks when you need to see what is inside a task or why it cannot be started. Notes are often a long work log of dated entries, so they come back as a window: by default the NEWEST entries that fit about 12,000 characters, with notesTruncated true when older entries were left out and notesLength giving the full size. Pass notesLastEntries (last N entries), notesSince (entries since a date) or notesMaxChars (a bigger or smaller budget) to choose the window. While notesTruncated is true you hold part of the log, so never send it back through update_task: add to it with append_task_note. Identify the task with taskId (the id list_tasks and create_task return), shortId (e.g. 123 for T-123) or taskVersionId; at least one is required, and shortId wins over taskId, which wins over taskVersionId. A task that does not exist or is not yours is a TASK_NOT_FOUND error, and an argument this tool does not declare is refused as INVALID_INPUT.

get_task_details

Pull visual context from a task's videos: extracts a few evenly-spaced frames from any uploaded video (screen recording etc.) in the task's notes or attachments so you can understand what it shows, and surfaces any YouTube/Vimeo links found in the notes. Use when a task references a video/screen recording. Identify the task with taskId (the id list_tasks and create_task return), shortId (e.g. 123 for T-123) or taskVersionId; at least one is required, and shortId wins over taskId, which wins over taskVersionId. A task that does not exist or is not yours is a TASK_NOT_FOUND error, and an argument this tool does not declare is refused as INVALID_INPUT.

get_task_video_context

Record that one task is BLOCKED BY another (finish-to-start), or remove that link. Use it whenever the user says one piece of work is waiting on, depends on, or is held up by another. The blocked task is then reported as blocked until every blocker is completed, so you can answer "what is blocking this?" by following the chain of blockers. Identify the blocker with blockerTaskId, blockerShortId (e.g. 123 for T-123) or blockerTaskVersionId and the blocked task with blockedTaskId, blockedShortId or blockedTaskVersionId; at least one per side is required (shortId wins over taskId, which wins over taskVersionId). Pass action "remove" to unlink. Links that would create a loop are rejected. A task that does not exist or is not yours is a TASK_NOT_FOUND error, and an argument this tool does not declare is refused as INVALID_INPUT.

link_task_dependency

List the members of the workspace with their userId, name, email and role. Pass a returned userId as `assigneeUserId` on create_task or update_task to assign a task to that person, or on list_tasks to see what they own. Only members of the workspace can be assigned, so look the person up here rather than guessing an id.

list_members

List the shared notes of the workspace: documents every member and every connected agent reads and writes, not tied to one task (conventions, decisions, runbooks, handover logs). Read this at the start of a session to pick up what other chats already know. Each note carries only the start of its text (preview) and its full length, so the list stays cheap to read; call get_note for the full text of one note. Archived notes are left out unless you pass includeArchived: true. Results are paged, by title (limit, default 50, max 200): while nextCursor is not null, call again with cursor set to it and the same other arguments to get the rest.

list_notes

List the projects in the workspace with their ids — the same grouping the board shows down the side of the task list. Call this BEFORE filing work under a project: pass a returned id as `projectId` on create_task or update_task, or as a filter on list_tasks. Archived projects are left out unless you pass includeArchived: true, and every project says whether it is archived. Results are paged (limit, default 50, max 200): while nextCursor is not null, call again with cursor set to it and the same other arguments to get the rest. If the project the user named is not in this list it does not exist, so say so (or create it with create_project when the user asks for a new one) rather than inventing it or writing its name into a task.

list_projects

See what happened in the workspace recently: the last task changes across all members and agents, newest first. Each entry names the task (shortId + name), what changed (status, priority, name, notes), who did it and when, and how (session, API key or OAuth client). Use this at the start of a session to catch up on what other agents and people have been doing, or to detect conflicts before editing a task someone else just changed. Returns at most `limit` entries (default 20, max 100).

list_recent_activity

List tasks in the workspace. Can filter by status, priority, project and owner/assignee (`assigneeUserId`, a userId from list_members). Returns the latest version of each task — including its owner (ownerUserId and ownerName), the projects it is filed under, whether it is currently BLOCKED and how many tasks it blocks — so you can tell what is actually actionable right now, where it belongs and who owns it. To keep the list cheap to read, each task carries only the start of its notes and description (notesPreview, descriptionPreview) and their full lengths (notesLength, descriptionLength); call get_task_details to read the notes of one task, or pass includeNotes: true only when you really need the full text of every task (pages are then at most 20 tasks, and a bigger limit is refused as INVALID_INPUT). Results are paged, newest task first (limit, default 50, max 200): while nextCursor is not null, call again with cursor set to it and the same filters until it is null, or you will miss tasks.

list_tasks

List the workspaces (organizations) this connection can use, with their ids: the workspaces the user chose when approving the connection, or every workspace they belong to for an API key. Pass a returned id as `workspaceId` on the other tools to target a specific workspace when there is more than one.

list_workspaces

Search the GetItDone developer documentation — REST API operations, error/problem codes, and guide pages — and return ranked results with their public URLs. Guide and error pages also return a Markdown-twin URL (the page URL plus '.md') the agent can fetch to read the full page as plain text. Use when you need to know how a /v1 endpoint works, what an error code means, or where a capability is documented.

search_docs

Rewrite a shared workspace note: its title, its WHOLE text, its project, or archive or unarchive it. Pass baseUpdatedAt, the updatedAt of the note as you last read it; if someone changed the note since, the update is refused so you can re-read it and apply your change again instead of overwriting their edit. To add to a note, use append_note instead. A note that does not exist or is not in a workspace you can use is a NOTE_NOT_FOUND error.

update_note

Rename a project or change its description. Identify the project by its id from list_projects; pass description null to clear it. A name already used by another project in the workspace is refused.

update_project

Update an existing task. You can update the name, status, priority, start date, due date, notes, story points, its project (pass a project id from list_projects to move it, or null to remove it from every project), its owner/assignee (pass a userId from list_members as `assigneeUserId`, or null to unassign), or its repeat schedule (pass a recurrence to start/replace it, or null to stop it repeating). Identify the task with `taskId` (the id list_tasks and create_task return), its short ID (e.g. T-123) as `shortId`, or `taskVersionId`; a call that names none of them is refused, and so is an argument this tool does not declare (INVALID_INPUT).

update_task