Add Task Tool
add_taskCreate a single project task for yourself, a colleague, or anyone to take, with optional notes, due date, or repeat schedule.
Instructions
Creates one task on a project: free (anyone can take it), for the person themself ("me") or for a colleague who works on the project, with optional notes (steps as - [ ] lines), a due date or a repeat. Use it only when the person asks, after confirming the title and who does it; for an idea for later pass it as an idea, to change an existing task use update_task, to start working on one use start_task. Fails on archived projects or when the assignee is not on the project. Returns the task, with its number (#id).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>"
},
"name": "add_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| due | No | Optional due date, YYYY-MM-DD, when the person gives one ("by Thursday"). | |
| idea | No | true: an idea for later (the person says "idea", "someday", "note this"), not work to do now; it has no person and stays out of the open tasks. | |
| repo | No | The git remote of the working directory (git remote get-url origin). Preferred: it finds the project by itself. | |
| notes | No | Optional details, in Markdown (a list, - [ ] steps, `code`, links). | |
| title | Yes | Short and concrete, e.g. "Newsletter sign-up form". | |
| repeat | No | Optional, when the person says it comes back ("every month", "every Monday"): when it is done, the next one is added by itself, due one interval later. Give a due date too (the first one). | |
| project | No | Project slug or name, when there is no repo. | |
| session | No | This session's id, from the cemainou line at the start of the session. The session's project wins over the repo. | |
| assignee | No | "me", a colleague's name or email; leave empty for a free task. |