create_task
Crea una tarea en el workspace. Nace pending, con source_type: 'mcp'.
RESPONSABLE — `assignee` es UNA persona del Atlas (nombre canónico o id) y
es lo que contesta "¿de quién es?". No es lo mismo que `people`, que son
las personas RELACIONADAS (aparecen en la nota, hay que avisarles), ni que
`owner` ('yo' | 'otro'), que dice si se delegó pero no a quién. Se valida
que la persona sea de ESTE workspace: un responsable de otro no se ve en
ningún tablero de éste y quedaría una tarea con dueño invisible.
FECHA vs HORA — `due_date` es el día en que vence. Si además pasás
`remind_time` ("HH:MM", en la zona del usuario), la tarea se vuelve un
RECORDATORIO: suena el teléfono a esa hora. Eso escribe tres cosas —la
línea en la nota del día, su segmento y la fila del cron—, porque guardar la
hora en la tarea NO la hace sonar: el cron mira la tabla `reminders` y nada
más, y la línea de la nota es la fuente de verdad (borrarla cancela el
aviso). Si la hora ya pasó, la tarea se crea igual y la respuesta avisa que
el aviso no se programó — prometer uno que no puede sonar es peor que no
prometerlo.
TRAMO — `start_date`/`end_date` es cuánto dura en la línea de tiempo.
Declararlo fija también `due_date` igual al fin, para que la barra y la
pastilla de la lista no digan cosas distintas. Sin tramo la tarea se dibuja
como un rombo en su vencimiento, que es lo correcto: "dura un día" no lo
dijo nadie.
BACKLOG — `backlog: true` la deja pendiente pero fuera del radar. No es un
estado: convive con `pending`.
PRIVADA — `private: true` la saca de todo listado compartido: no entra en
ningún tablero ni siquiera incluida a mano. Una privada tampoco sube a
ClickUp ni a Jira.
DÓNDE VIVE — por defecto la tarea nace en Secondbrain y, si el workspace
tiene una lista de ClickUp o un proyecto de Jira "por defecto", sube sola
ahí (la respuesta lo dice en `destino_externo`). Para decidirlo:
· `jira_project` — "creala en Jira": clave, nombre o id del proyecto.
· `clickup_list` — "en ClickUp / en la lista UBI": nombre o id de la lista.
· `solo_en_secondbrain: true` — que NO suba a ninguna herramienta.
Se pasa UNO. Si no se sabe cómo se llama el destino, get_task_destinations
los lista. La sube la sync en segundos con la conexión del workspace.Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | No | ¿La hago yo o está delegada? No dice a quién — para eso está assignee | |
| title | Yes | Título descriptivo de la tarea | |
| people | No | Personas RELACIONADAS (nombres canónicos del Atlas). No es el responsable. | |
| urgent | No | Marcarla urgente a mano, más allá de lo que diga la fecha | |
| backlog | No | Apartarla del radar sin dejar de estar pendiente | |
| private | No | No se comparte a ningún tablero, nunca | |
| urgency | No | Sólo se usa si no hay due_date: con fecha, la urgencia se deriva de ella | |
| assignee | No | Responsable: nombre canónico de la persona en el Atlas, o su id numérico | |
| due_date | No | Vencimiento, YYYY-MM-DD | |
| end_date | No | Fin del tramo, YYYY-MM-DD (fija due_date al mismo día) | |
| projects | No | Nombres canónicos de proyectos del Atlas | |
| start_date | No | Inicio del tramo, YYYY-MM-DD | |
| description | No | Contexto, notas, o qué hay que hacer exactamente | |
| remind_time | No | Hora del aviso, 'HH:MM' en la zona del usuario. Requiere due_date. Convierte la tarea en recordatorio. | |
| clickup_list | No | Crearla también en ClickUp: nombre o id de la lista. Ver get_task_destinations | |
| jira_project | No | Crearla también en Jira: clave («SB»), nombre o id del proyecto. Ver get_task_destinations | |
| workspace_id | No | UUID del workspace, o su nombre tal como lo dice el usuario ('Acme', 'el personal'). Omitir si el token ya tiene workspace fijo | |
| organizations | No | Nombres canónicos de organizaciones del Atlas | |
| deliverable_id | No | Entregable al que pertenece (ver get_deliverables) | |
| solo_en_secondbrain | No | No subirla a ClickUp ni a Jira, ni siquiera a la lista por defecto |