Skip to main content
Glama

create_task

Destructive

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.

Fuera de Secondbrain: avisa al responsable y a las personas relacionadas (push, WhatsApp/Telegram o mail) y, con ClickUp o Jira conectado, la sube allá.

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": "create_task"
  }
}

Input Schema

NameRequiredDescriptionDefault
ownerNo¿La hago yo o está delegada? No dice a quién — para eso está assignee
titleYesTítulo descriptivo de la tarea
peopleNoPersonas RELACIONADAS (nombres canónicos del Atlas). No es el responsable.
urgentNoMarcarla urgente a mano, más allá de lo que diga la fecha
backlogNoApartarla del radar sin dejar de estar pendiente
privateNoNo se comparte a ningún tablero, nunca
urgencyNoSólo se usa si no hay due_date: con fecha, la urgencia se deriva de ella
assigneeNoResponsable: nombre canónico de la persona en el Atlas, o su id numérico
due_dateNoVencimiento, YYYY-MM-DD
end_dateNoFin del tramo, YYYY-MM-DD (fija due_date al mismo día)
projectsNoNombres canónicos de proyectos del Atlas
start_dateNoInicio del tramo, YYYY-MM-DD
descriptionNoContexto, notas, o qué hay que hacer exactamente
remind_timeNoHora del aviso, 'HH:MM' en la zona del usuario. Requiere due_date. Convierte la tarea en recordatorio.
clickup_listNoCrearla también en ClickUp: nombre o id de la lista. Ver get_task_destinations
jira_projectNoCrearla también en Jira: clave («SB»), nombre o id del proyecto. Ver get_task_destinations
workspace_idNoUUID del workspace, o su nombre tal como lo dice el usuario ('Acme', 'el personal'). Omitir si el token ya tiene workspace fijo
organizationsNoNombres canónicos de organizaciones del Atlas
deliverable_idNoEntregable al que pertenece (ver get_deliverables)
solo_en_secondbrainNoNo subirla a ClickUp ni a Jira, ni siquiera a la lista por defecto

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations: it discloses that remind_time writes three separate records (day-note line, segment, cron row), that deleting the note line cancels the alert, that a past time still creates the task with an explicit warning in the response, and that private tasks never sync to ClickUp/Jira. It also states the default escalation to a workspace's default ClickUp list/Jira project and that notifications go out via push/WhatsApp/Telegram/email.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Capitalized section headers make a long definition skimmable and each block covers a distinct concept, so length is largely justified by 20 parameters. A few editorial asides ('prometer uno que no puede sonar es peor que no prometerlo', the rhombus remark) add tone rather than information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 20-parameter write tool with no output schema, it covers side effects, destination resolution, validation failures (assignee from another workspace), and even names a response field (destino_externo). The only uncovered area, duplicate creation, is already declared by idempotentHint: false.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns above that by establishing the assignee vs people vs owner hierarchy and the invariant that exactly one of jira_project/clickup_list/solo_en_secondbrain is passed. Several points (remind_time requires due_date, end_date fixes due_date) overlap with schema text, limiting it to a 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a precise verb+resource ('Crea una tarea en el workspace') and immediately adds the resulting initial state ('Nace pending, con source_type: mcp'), which no sibling create_* tool would produce. The scope is unmistakable versus create_event, create_meeting or update_task.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit routing guidance for the destination decision ('Si no se sabe cómo se llama el destino, get_task_destinations los lista') and conditions for each optional behavior (backlog, private, solo_en_secondbrain). It does not contrast create_task against other creation tools (event/meeting/deliverable), so tool-level exclusion is left implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources