shortcut

name	shortcut
version	1.2.0
description	Manage stories on Shortcut.com kanban boards. Use when creating, updating, or listing tasks/stories on Shortcut project management boards. Supports creating stories with descriptions and types (feature/bug/chore), updating story status, and listing active/completed stories. Includes full checklist task management and comment support.

Shortcut Kanban Integration

Manage tasks and stories on Shortcut.com project boards via API.

Prerequisites

• Shortcut API token configured via one of:
  • Environment variable: SHORTCUT_API_TOKEN
  • File: ~/.config/shortcut/api-token
• Access to a Shortcut workspace with appropriate permissions

Setup

1. Get your API token from Shortcut.com (Settings → API Tokens)
2. Store it either:
   • As environment variable: export SHORTCUT_API_TOKEN="your-token"
   • In a file: echo "your-token" > ~/.config/shortcut/api-token && chmod 600 ~/.config/shortcut/api-token
3. Optionally add to ~/.bashrc for persistence:

   export SHORTCUT_API_TOKEN=$(cat ~/.config/shortcut/api-token 2>/dev/null | tr -d '\n')
   

Available Operations

List Stories

scripts/shortcut-list-stories.sh [--active|--completed|--all] [--json]