Projects

Fetch one project by its ID. Requires a real projectId; use projects_queryProjects first when the ID is unknown.

Search projects by free text, status, priority, tag, or area. Use status 'active' with a small limit for current outcomes. Rows are compact summaries (id, name, status, targetDate, milestoneCount, progress); use projects_getProject (or detail 'full') when the user needs the summary/outcome text or milestone list.

Create a project for a serious multi-step outcome; do not create one for a single one-off task. Capture name, summary, outcome (definition of done), status, priority, area, startDate/targetDate (YYYY-MM-DD), tags, and milestones. Example: name 'Launch Vritto beta', status 'active', targetDate '2026-08-01', tags ['work'].

{
  "project": {
    "name": "Kitchen remodel",
    "outcome": "A kitchen we cook in every night",
    "status": "active",
    "targetDate": "2027-03-01"
  }
}

Apply a partial update to one project; only the fields present in patch change. Requires projectId. Example: patch { progress: 40 }.

Delete a project (marks it cancelled and archived). Only for explicit deletion requests.

Search tasks owned by the Projects module across boards and timelines; filter by projectId, free text, status, priority, or tag. ALWAYS pass dueOnOrBefore when the question concerns near-term work (this week, overdue). Rows are compact summaries; pass detail 'full' only when the user needs complete task notes.

Create a work item inside a project board; task.projectId and task.title are required. Set status, priority, dueDate, effortPoints (relative effort for workload and weighted progress), assignees, and tags when known.

{
  "task": {
    "projectId": "proj_kitchen",
    "title": "Get three contractor quotes",
    "dueDate": "2026-10-15",
    "priority": "high"
  }
}

Apply a partial update to one project task; only the fields present in patch change. Requires projectTaskId and patch.

Copy and link one project task into the global Tasks module so it appears in the user's general task list. Use only when the user explicitly asks to copy or link a project task into Tasks.

Set one project task's status (todo, in_progress, blocked, done, cancelled), optionally with a new board sortOrder. Requires projectTaskId and status. Example: { projectTaskId, status: 'done' }.