Packs

List task packs

task_management.packs.list

Lists task packs (reusable lists of tasks with deadlines relative to an anchor date) in their manual order, paginated by cursor: the organization's own (source org, default) or the published templates of the MB Suite library (source system), which can be applied directly or cloned into the organization. A pack carries name, description, color, labels and item_count; its tasks are in task_management.packs.items.list. Every pack of the organization comes, ordered by order ascending: a pack saved without a position (older packs) counts as 0 and comes back with order 0, and ties go by id. That holds up to 200 packs; an organization with more is listed by its stored position, and a pack without one is left out. Cost: the organization's packs are read whole (one read per pack, up to 200, plus one); the library, one read per pack of the page.

Alcance

task_management:read

Permiso

Ver el módulo

Tool del MCP

task_management_packs_listEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.list".

Costo declarado: hasta 203 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/tasks/packs" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/tasks/packs" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Get one task pack

task_management.packs.get

Returns one task pack: the organization's, or a published one of the MB Suite library (is_system_pack). Without source it looks in the organization first and then in the library. Its tasks are in task_management.packs.items.list.

Alcance

task_management:read

Permiso

Ver el módulo

Tool del MCP

task_management_packs_getEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.get".

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/tasks/packs/{pack_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/tasks/packs/{pack_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

List the tasks of a pack

task_management.packs.items.list

Lists the items of a task pack in order: title, description, days_offset (days from the anchor date when applied; negative, zero or positive), priority, subtasks and recurrence. Works for the organization's packs and the published library packs.

Alcance

task_management:read

Permiso

Ver el módulo

Tool del MCP

task_management_packs_items_listEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.items.list".

Costo declarado: hasta 203 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a task pack

task_management.packs.create

Creates an empty task pack at the end of the organization's list, owned by the caller: name, optional description, color (hex, default #3b82f6) and pack labels (unknown label ids are ignored). Add its tasks with task_management.packs.items.add. Returns the pack.

Alcance

task_management:write

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_createEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.create".

Costo declarado: hasta 52 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/tasks/packs" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

Update a task pack

task_management.packs.update

Changes one of the organization's task packs. Send the fields to change inside updates: name, description, color (hex like #3b82f6) or label_ids (pack labels; unknown ids are ignored); only what you send changes. Any other key inside updates is rejected (400 invalid_input). To edit the tasks of the pack use task_management.packs.items.update. Returns the pack.

Alcance

task_management:write

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.update".

Costo declarado: hasta 52 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/tasks/packs/{pack_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X PATCH "https://api.mb-suite.com/v1/tasks/packs/{pack_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Delete a task pack

task_management.packs.delete

Deletes one of the organization's task packs with all its items. It goes to the 30-day trash and comes back whole (items included). Tasks already created from the pack are not touched. Outside the app it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete.

Con una API key, este DELETE se ejecuta directo: el registro queda 30 días en la papelera y la respuesta trae su trash_item_id. Con un token OAuth, y por el MCP, pide dry_run → confirm_token.

Alcance

task_management:write y «Permitir eliminar» (task_management:delete en OAuth)

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.delete".

Costo declarado: hasta 1001 lecturas y 1001 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/tasks/packs/{pack_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X DELETE "https://api.mb-suite.com/v1/tasks/packs/{pack_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Duplicate a task pack

task_management.packs.duplicate

Copies one of the organization's task packs with all its items into a new pack named '<name> (Copy)' (the suffix in the caller's language: '(Copia)', '(Copy)' or '(Cópia)'), owned by the caller. Returns pack_id and the new pack.

Alcance

task_management:write

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_duplicateEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.duplicate".

Costo declarado: hasta 1001 lecturas y 1002 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/duplicate" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/duplicate" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Copy a library pack into the organization

task_management.packs.clone_system

Copies a published task pack of the MB Suite library (an id from task_management.packs.list with source system) into the organization, items included, so it can be edited. Drafts of the library cannot be copied. Returns pack_id and the new pack.

Alcance

task_management:write

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_clone_systemEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.clone_system".

Costo declarado: hasta 1002 lecturas y 1002 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/system/{system_pack_id}/clone" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/system/{system_pack_id}/clone" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create the tasks of a pack

task_management.packs.apply

Creates one task per item of a pack (the organization's or a published library pack), due on anchor_date + the item's days_offset days, with the item's subtasks, priority and recurrence. target says where they go: the workspace (default), one of its Accounts (kind account + account_id) or private. Every task is assigned to default_assignee_id (default: the caller; null leaves them unassigned); items can override their assignee or due date, or be skipped (include: false). Subtasks are created unassigned, like in the app. Up to 200 items and 1,000 tasks with subtasks. Outside the app it requires a dry run (which lists the tasks and dates) and a confirm_token. Returns tasks_created (the top-level tasks, whose ids come in task_ids), subtasks_created and has_stale_end_date (a recurrence end date already past was dropped).

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance

task_management:write

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_applyEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.apply".

Eventos que puede emitir

task_management.task.created

Costo declarado: hasta 600 lecturas y 1000 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/apply" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "anchor_date": 0,
  "dry_run": true
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/apply" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "anchor_date": 0,
  "dry_run": true
}'

Add a task to a pack

task_management.packs.items.add

Adds an item to one of the organization's task packs: title, description, days_offset (days from the anchor date when the pack is applied), priority, subtasks (titles) and recurrence; at the end of the pack unless order is given. Returns the item.

Alcance

task_management:write

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_items_addEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.items.add".

Costo declarado: hasta 2 lecturas y 2 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE",
  "days_offset": 0
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE",
  "days_offset": 0
}'

Edit a task of a pack

task_management.packs.items.update

Changes an item of one of the organization's task packs. Send the fields to change inside updates: title, description (the description of the task it creates, up to 5,000 characters; an empty text clears it), days_offset, priority_id (null clears it), subtasks (the whole list of titles), recurrence (null removes it) or order; only what you send changes. Any other key inside updates is rejected (400 invalid_input); a field sent next to updates instead of inside it is ignored, and without updates the call is 400 invalid_input. Returns the item with its fields.

Alcance

task_management:write

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_items_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.items.update".

Costo declarado: hasta 3 lecturas y 2 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X PATCH "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Remove a task from a pack

task_management.packs.items.delete

Removes an item from one of the organization's task packs (tasks already created from it are not touched). It stays 30 days in the trash. Outside the app it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete.

Con una API key, este DELETE se ejecuta directo: el registro queda 30 días en la papelera y la respuesta trae su trash_item_id. Con un token OAuth, y por el MCP, pide dry_run → confirm_token.

Alcance

task_management:write y «Permitir eliminar» (task_management:delete en OAuth)

Permiso

Editar en el módulo

Tool del MCP

task_management_packs_items_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.packs.items.delete".

Costo declarado: hasta 2 lecturas y 2 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X DELETE "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"