create-story

Generate a new Shortcut story with required name and optional team or workflow details. Specify team to use default workflow or directly assign a workflow for precise placement in the project management system.

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
`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"
    },
    "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

create-story

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Shortcut MCP Server

Related Tools

MCP directory API