Shortcut

Shortcut MCP integration

Searches for the story behind a bug report, files new ones from the conversation, links duplicates, and reports where the work stands.

136actions available

Three actions you can hand over today

Every action runs live through MCP. Nothing to build, nothing to maintain.

  • Search

    Lyro finds Epics and Stories in Shortcut based on search criteria. Agents quickly locate relevant work items to reference when helping customers.

  • Upload files

    Lyro uploads attachments to Shortcut and links them to work items. Agents attach customer screenshots and evidence directly to tasks.

  • Delete task

    Lyro removes a task from the backlog. Agents keep Shortcut clean by eliminating invalid or duplicate work without manual cleanup.

See all 136 actions

How businesses use Shortcut + Lyro

Each card is one request a support team gets, and the Shortcut actions Lyro runs to close it.

  • Say where a reported bug actually stands

    Lyro searches Shortcut for the story matching a customer's report, opens it, and reads its history, so the reply names the current workflow state instead of promising to check with the team.

    Search StoriesGet StoryStory History
  • File the bug straight from the conversation

    Lyro creates the story in the customer's own words, breaks out the tasks the fix will need, and posts the reproduction steps as a comment, so engineering opens something complete.

    Create StoryCreate TaskCreate Story Comment
  • Keep the backlog sorted as reports pile up

    Lyro links the third report of the same fault to the original story, labels it by area, and updates a batch of stories in one pass, so the queue a team grooms is not three copies of one bug.

    Create Story LinkCreate LabelUpdate Multiple Stories
  • Follow a story back to the doc behind it

    Lyro pulls the stories attached to an external link, adds the file that explains the case, and connects the document to the epic that owns the work, so context is not stranded in another tool.

    Get External Link StoriesCreate Linked FileLink Document to Epic

How it works

Get started in 3 steps

Connect once, then just ask. There is no workflow builder to learn and nothing to maintain — Lyro reads the Shortcut actions it has and picks the ones a request needs.

  1. 01

    Connect Shortcut

    Authorize the Shortcut account your team already uses — one consent screen, no API keys, no mapping tables. Lyro can only do what you granted that account, and you can disconnect it at any time.

  2. 02

    Tell your agent what you need

    Describe the job the way you would hand it to a teammate. Lyro maps it to the Shortcut actions that close it and chains as many as the request needs.

  3. 03

    Watch it work

    The agent runs the actions inside the conversation the customer is already in, so nobody copies data between tabs and your team can take over at any point.

    Get started free
Shortcut · Lyro

Everything else about Shortcut

Setup, permissions, and the limits of what Lyro can do inside Shortcut.

  • Your own. Get Workflow and List Workflows return the states your team defined, Get Epic Workflow covers the epic side, and List Custom Fields with Get Custom Field expose the fields you added, so a status Lyro reports back is the one on your board rather than a normalised label.

Every action available in Shortcut

All 136 actions your agent can call on Shortcut, straight from the live MCP connection.

  • Create category

    Create Category allows you to create a new Category in Shortcut.

  • Create doc

    Create Doc allows you to create a new document in Shortcut.

  • Create entity template

    Create a new entity template for the Workspace.

  • Create epic

    Create Epic allows you to create a new Epic in Shortcut.

  • Create epic comment

    This endpoint allows you to create a threaded Comment on an Epic.

  • Create epic comment comment

    This endpoint allows you to create a nested Comment reply to an existing Epic Comment.

  • Create epic health

    Create a new health status for the specified Epic.

  • Create generic integration

    Create a generic webhook integration in Shortcut.

  • Create group

    Creates a new group in the Shortcut system with customizable properties.

  • Create iteration

    The CreateIteration endpoint allows you to create a new Iteration in Shortcut, which represents a time-boxed period for completing a set of stories or tasks.

  • Create label

    Create Label allows you to create a new Label in Shortcut.

  • Create linked file

    Create Linked File allows you to create a new Linked File in Shortcut.

  • Create multiple stories

    Create Multiple Stories allows you to create multiple stories in a single request using the same syntax as [Create Story](https://developer.shortcut.com/api/rest/v3#create-story).

  • Create objective

    Create Objective allows you to create a new Objective in Shortcut.

  • Create project

    Create Project is used to create a new Shortcut Project.

  • Create story

    Create Story is used to add a new story to your Shortcut Workspace.

  • Create story comment

    Create Comment allows you to create a Comment on any Story.

  • Create story from template

    Create Story From Template is used to add a new story derived from a template to your Shortcut Workspace.

  • Create story link

    Story Links (called Story Relationships in the UI) allow you create semantic relationships between two stories.

  • Create story reaction

    Create a reaction to a story comment.

  • Create task

    Create Task is used to create a new task in a Story.

  • Delete category

    Delete Category can be used to delete any Category.

  • Delete custom field

    Deletes a specific custom field from the Shortcut system using its unique public identifier.

  • Delete doc

    Permanently deletes a Doc and its associated data from Shortcut.

  • Delete entity template

    Deletes a specific entity template from the Shortcut API.

  • Delete epic

    Delete Epic can be used to delete the Epic.

  • Delete epic comment

    This endpoint allows you to delete a Comment from an Epic.

  • Delete file

    Delete File deletes a previously uploaded file.

  • Delete generic integration

    Delete a generic webhook integration from Shortcut.

  • Delete iteration

    Deletes a specific iteration from the Shortcut project management system.

Ready to connect Shortcut?

Authorize the account and your agent has all 136 actions from the first conversation.

Support agent working at a laptop next to the Lyro mascot