---
title: "Shortcut integration for LuumenAI"
url: "https://www.luumen.ai/integrations/shortcut/"
entity: SoftwareIntegration
category: "Project management"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Shortcut integration for LuumenAI

Read epics, docs, and templates in Shortcut, and post updates as approved steps.

## What LuumenAI can do with Shortcut

LuumenAI connects to Shortcut with an API token and exposes 136 tools (67 read-only · 46 write · 23 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 136 tools (67 read-only · 46 write · 23 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Project management

## About Shortcut with LuumenAI

Connect Shortcut and Luumen can read your epics, their health history, comments, docs, categories, and entity templates without leaving the terminal. When work needs recording — a health update on a slipping epic, a comment with incident context, a new doc — Luumen drafts the change, shows it to you, and waits for approval before writing. Authentication is by API key.

## Example tools

Read-only (67 in total):

- `SHORTCUT_GET_CATEGORY` — Get Category returns information about the selected Category.
- `SHORTCUT_GET_CURRENT_MEMBER_INFO` — Returns information about the authenticated member.
- `SHORTCUT_GET_CUSTOM_FIELD` — Retrieves detailed information about a specific custom field in Shortcut using its unique public identifier.
- `SHORTCUT_GET_DOC` — Get Doc returns information about a chosen Doc by its public ID.
- `SHORTCUT_GET_ENTITY_TEMPLATE` — Get Entity Template returns information about a given entity template.
- `SHORTCUT_GET_EPIC` — Get Epic returns information about the selected Epic.
- `SHORTCUT_GET_EPIC_COMMENT` — This endpoint returns information about the selected Epic Comment.
- `SHORTCUT_GET_EPIC_HEALTH` — Get the current health status for the specified Epic.

Write and destructive (69 in total, subject to configured approval policy):

- `SHORTCUT_CREATE_CATEGORY` — Create Category allows you to create a new Category in Shortcut.
- `SHORTCUT_CREATE_DOC` — Create Doc allows you to create a new document in Shortcut.
- `SHORTCUT_CREATE_ENTITY_TEMPLATE` — Create a new entity template for the Workspace.
- `SHORTCUT_CREATE_EPIC` — Create Epic allows you to create a new Epic in Shortcut.
- `SHORTCUT_CREATE_EPIC_COMMENT` — This endpoint allows you to create a threaded Comment on an Epic.
- `SHORTCUT_CREATE_EPIC_COMMENT_COMMENT` — This endpoint allows you to create a nested Comment reply to an existing Epic Comment.
- `SHORTCUT_CREATE_EPIC_HEALTH` — Create a new health status for the specified Epic.
- `SHORTCUT_CREATE_GENERIC_INTEGRATION` — Create a generic webhook integration in Shortcut.

## Frequently asked questions

### How does LuumenAI connect to Shortcut?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Shortcut on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Shortcut — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/shortcut/