Create Shortcut Story
create_storyCreate a new story in a Shortcut project with required name and project ID, plus optional description, type, deadline, and labels.
Instructions
Create a new Shortcut story in a project.
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": {
"name": "<name>",
"project_id": "<project_id>"
},
"name": "create_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| confirm | No | Must be CONFIRM_WRITE to execute | |
| dry_run | No | ||
| epic_id | No | ||
| deadline | No | ISO 8601 date for the story deadline, e.g. 2026-03-13T23:59:59Z | |
| estimate | No | ||
| label_ids | No | ||
| owner_ids | No | ||
| project_id | Yes | ||
| story_type | No | Defaults to feature | |
| description | No | ||
| follower_ids | No | Member UUIDs to add as watchers/followers | |
| iteration_id | No | ||
| custom_fields | No | Custom field values, e.g. priority | |
| requested_by_id | No |