---
title: "Kiwi for Shortcut"
description: "Have the agent on a Kiwi step read its Shortcut story, update its Sub-tasks and comment its result, through Shortcut's MCP server."
canonical: "https://kiwiflow.io/integrations/shortcut"
---

# Kiwi for Shortcut

Have the agent on a Kiwi step read its Shortcut story, update its Sub-tasks and comment its result, through Shortcut's MCP server.

- Your agent works in Shortcut through its own connection. Kiwi does not call Shortcut and never holds its credentials.
- A workflow skill can list Shortcut among the tools it requires. When you supply your agent's available tools to a skill check and Shortcut is not among them, the check reports `SK15-UNSUPPORTED-TOOL`.
- A project Admin can add links to Shortcut, with notes, under Connections and bind them to the steps that use them. The agent reads them with `list_connections`.
- The agent can report the tools and plugins it ran with, including its Shortcut connection, with `report_configuration`.
- The agent submits links to its work in Shortcut as the step's outputs. People review them, and sign-off stays with the people your workflow names.

## What your agent can do in Shortcut

- Read, create and update Stories, including their comments and Sub-tasks.
- Create and read Epics and Iterations to group related work.
- Read, create and update Docs, for example to record a design note.
- Look up Teams, Members, Workflows and Objectives, which the server exposes read-only.

## Set up

### 1. Connect your agent to Kiwi

Add Kiwi's hosted MCP server, `https://kiwiflow.io/mcp`, to your coding agent.

- [Coding agents](https://kiwiflow.io/integrations#agent)
- [Quickstart](https://docs.kiwiflow.io/quickstart#connect-your-agent)

### 2. Connect your agent to Shortcut

Add the Shortcut MCP server to your agent with this URL. The credentials stay with your agent.

```
https://mcp.shortcut.com/mcp
```

- [Shortcut documentation](https://www.shortcut.com/help/integrations/mcp-server/)

### 3. Example skill

Publish instructions like these as a workflow skill that lists Shortcut among its required tools.

```
Read the Shortcut story ID from the run's inputs and fetch the story.
Work through its Sub-tasks and update each one as you finish it.
Add a comment to the story that links the pull request.
Submit the story URL and the pull request link as the step's outputs.
Moving the story to Done stays with the story's owner.
If the story cannot be read, call report_blocker with the story ID.
```

## More issue tracking integrations

- [Kiwi for Jira](https://kiwiflow.io/integrations/jira.md): Have the agent on a Kiwi step read its Jira work item, comment on it and move it to the next status, through the Atlassian Rovo MCP Server.
- [Kiwi for Trello](https://kiwiflow.io/integrations/trello.md): Have the agent on a Kiwi step move its Trello card across the board and comment its result, through Trello's MCP server.
- [Kiwi for Azure Boards](https://kiwiflow.io/integrations/azure-boards.md): Have the agent on a Kiwi step read its Azure Boards work item, comment on its progress and link the pull request, through Microsoft's Azure DevOps MCP server.
- [Kiwi for Asana](https://kiwiflow.io/integrations/asana.md): Have the agent on a Kiwi step read its Asana task and add follow-up tasks to the project, through Asana's MCP server.
- [Kiwi for Linear](https://kiwiflow.io/integrations/linear.md): Have the agent on a Kiwi step read the Linear issue it works on and post its findings as a comment, through Linear's MCP server.
- [Kiwi for ClickUp](https://kiwiflow.io/integrations/clickup.md): Have the agent on a Kiwi step update its ClickUp task, log its time and comment on progress, through ClickUp's MCP server.
- [Kiwi for YouTrack](https://kiwiflow.io/integrations/youtrack.md): Have the agent on a Kiwi step read its YouTrack issue, hand it to a reviewer and log the time it spent, through YouTrack's MCP server.
- [Kiwi for monday dev](https://kiwiflow.io/integrations/monday-dev.md): Have the agent on a Kiwi step read its monday dev sprint, set its item's status and post an update with its result, through the monday MCP server.
- [Kiwi for Plane](https://kiwiflow.io/integrations/plane.md): Have the agent on a Kiwi step update its Plane work item, comment its result and log its time, through Plane's MCP server.

- [Get started](https://kiwiflow.io/get-started)
- [Read the setup guide](https://docs.kiwiflow.io/other-tools)