create-story

create-story

Generate and add new stories to Shortcut projects using a specified team or workflow. Provide a story name and optional details like description, type, owner, or epic. Streamlines project management integration.

Instructions

Create a new Shortcut story. Name is required, and either a Team or Workflow must be specified:

If only Team is specified, we will use the default workflow for that team.
If Workflow is specified, it will be used regardless of Team. The story will be added to the default state for the workflow.

Input Schema

Name	Required	Description	Default
`description`	No	The description of the story
`epic`	No	The epic id of the epic the story belongs to
`iteration`	No	The iteration id of the iteration the story belongs to
`name`	Yes	The name of the story. Required.
`owner`	No	The user id of the owner of the story
`team`	No	The team ID or mention name of the team the story belongs to. Required unless a workflow is specified.
`type`	No	The type of the story	feature
`workflow`	No	The workflow ID to add the story to. Required unless a team is specified.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "description": {
      "description": "The description of the story",
      "maxLength": 10000,
      "type": "string"
    },
    "epic": {
      "description": "The epic id of the epic the story belongs to",
      "type": "number"
    },
    "iteration": {
      "description": "The iteration id of the iteration the story belongs to",
      "type": "number"
    },
    "name": {
      "description": "The name of the story. Required.",
      "maxLength": 512,
      "minLength": 1,
      "type": "string"
    },
    "owner": {
      "description": "The user id of the owner of the story",
      "type": "string"
    },
    "team": {
      "description": "The team ID or mention name of the team the story belongs to. Required unless a workflow is specified.",
      "type": "string"
    },
    "type": {
      "default": "feature",
      "description": "The type of the story",
      "enum": [
        "feature",
        "bug",
        "chore"
      ],
      "type": "string"
    },
    "workflow": {
      "description": "The workflow ID to add the story to. Required unless a team is specified.",
      "type": "number"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Shortcut MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Shortcut MCP Server

Related Tools

MCP directory API