backlog_create
Create a new backlog item with a title, optional description, parent links, and references. Supports tasks, epics, and cron items.
Instructions
Create a new item in the backlog.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Task title | |
| description | No | Task description in markdown | |
| source_path | No | Local file path to read as description. Mutually exclusive with description — provide one or the other. Server reads the file directly. | |
| type | No | Type: task (default) or epic | |
| epic_id | No | Parent epic ID to link this task to | |
| parent_id | No | Parent ID (any entity). Supports subtasks (task→task), epic membership, folder organization, milestone grouping. | |
| references | No | Reference links. Formats: external URLs (https://...), task refs (mcp://backlog/tasks/TASK-XXXX.md), resources (mcp://backlog/resources/{path}). Local files must include extension (file:///path/to/file.md) | |
| schedule | No | Cron expression (5 fields: min hour dom month dow). Required when type=cron. Not permitted on other types. | |
| command | No | Scheduler-invoked command. Required when type=cron. Interpreted by an external scheduler (e.g. studio-agents schedule), not backlog-mcp itself. | |
| enabled | No | Whether the external scheduler should tick this cron. Defaults to true on cron creation. Separate from status — status answers "does this matter?", enabled answers "should it run?". Not permitted on non-cron types. |