Integration · Projects and tasks
AI agents for Shortcut
Search, read, create and update Shortcut stories (state, owners, due date, estimate), comment on them and add checklist tasks, and look up workflows, teams, epics, iterations and members in a Shortcut workspace.
- Actions
- 13
- Read
- 9
- Write
- 4
Actions
What your agents can do in Shortcut
13 actions. Each one is a tool your agents can call and a step your workflows can run.
Read 9
Look things up. Nothing changes.
Search stories
Finds stories with Shortcut's search operators, like owner:jane state:"In Progress" type:bug, team:mobile is:started, epic:"Onboarding" or plain words matched against names and descriptions.
Get a story
Reads one story by its number (the digits in sc-123).
List story comments
Lists the comments on a story, oldest first.
List workflows
Lists the workspace's workflows and their states.
List members
Lists the workspace's members, to find the member IDs (UUIDs) used as owners and requesters.
List teams
Lists the workspace's teams (Shortcut calls them groups).
Search epics
Finds epics with words or search operators (like state:"in progress" or team:mobile).
List iterations
Lists the workspace's iterations (sprints).
Who am I
Reads the member the token acts as and its workspace.
Write 4
Create, change or send.
Create a story
Creates a story with a name and the workflow state it starts in (find state IDs with "List workflows"), and optionally a Markdown description, type.
Update a story
Changes a story by its number: move it to another workflow state (status), replace its owners, set the due date, estimate, name, description, type, epic, iteration or team, or archive it.
Comment on a story
Adds a Markdown comment to a story as the token's member, optionally as a reply in an existing thread.
Add a checklist task
Adds a checklist task to a story, with optional owners and an already-done flag.
A person can approve first
Any write action can be set to wait for a person's approval before it runs, so an agent asks before it changes anything.
Connection
How it connects
Connect it once in the console, then give it to the agents and workflows that need it.
Paste an API key from your Shortcut account.
What you enter
- API token
Kept safe
- Credentials are stored encrypted with your organization's own keys.
- They are opened only by the process that makes the call, at the moment it runs, and never go into a prompt or the browser.
- Calls go only to the tool's own servers.
Ideas
Ideas to start with
Starting points made only from the actions above. Mix them with any other tool your agents can use.
- 01
Ask about your Shortcut data
Ask a question in plain words. The agent can search stories, get a story or list story comments in Shortcut, then answers with what it found.
- 02
Let an agent update Shortcut
Have the agent create a story or update a story in Shortcut as part of a larger task. Turn on approval and a person signs off on each change first.
- 03
Share what it finds in Slack
Give one agent Shortcut and Slack: it can search stories in Shortcut and post a summary to a Slack channel in the same run.
Works well with
More Projects and tasks tools
- Jira5 actionsCreate, search, comment on and move Jira Cloud issues on your Atlassian site, signed in with an email address and an API token.
- Asana5 actionsCreate, read, update and complete Asana tasks and comment on them, in the workspaces a personal access token can reach.
- Linear5 actionsCreate, find and comment on Linear issues in the teams a personal API key can reach.
- Trello4 actionsCreate Trello cards, comment on them and move them between lists, on the boards your Trello account can reach.
- ClickUp4 actionsCreate, read and update ClickUp tasks and comment on them, in the Workspaces a personal API token can reach.
- monday.com3 actionsCreate items on monday.com boards, post updates on them, and read items with their column values, with a personal API token.
FAQ
Shortcut and MyDeepAgents
Can MyDeepAgents connect to Shortcut?
Yes. The Shortcut connector has 13 actions: 9 read and 4 make changes. Your agents can call them as tools, and your workflows can run them as steps.
How do I connect Shortcut?
Paste an API key from your Shortcut account. You'll need: API token. Credentials are stored encrypted with your organization's own keys and are opened only at the moment of a call.
Can an agent change data in Shortcut without asking?
Only if you let it. Each of the 4 actions that change data can be set to wait for a person's approval before it runs.
Can I use Shortcut in workflows as well as agents?
Yes. Every Shortcut action also works as a step in a workflow, and the same connection serves your agents and your workflows.
Early access
Put Shortcut to work
Connect it in a few minutes, give an agent the actions it needs, and decide which changes wait for a person.