Integration · Projects & tasks

Connect Claude & ChatGPT to Shortcut

Ask your AI what is still in progress this sprint, which bugs are assigned to you, or to write up a new story from a bug report. It searches and reads stories, epics, iterations, teams and workflows in Shortcut. It can also create and update stories and epics, move stories between workflow states, add comments and tasks, and set up a new iteration.

Connect Shortcut free

Free plan, no credit card. Takes about a minute.

Try asking

“What is still in progress in the current iteration?”
The AI finds the iteration, lists its stories and shows each one's state and owners.
“Create a bug: login fails on Safari, and assign it to me.”
It looks up your member ID and creates a bug story with you as owner.
“Move story 4821 to Done.”
It finds the Done state in your workflow and moves the story there.

What your AI can do

Stories

Search with Shortcut search syntax or exact filters, create and update stories, and add comments and checklist tasks.

Epics and iterations

List, read and create epics and iterations, see progress stats and list the stories in each.

Teams and workflows

List teams, members, labels and workflow states, so the AI can assign work and move stories to the right state.

“How far along is the billing epic?”
It reads the epic with its state, owners and progress stats.
“Summarize the discussion on story 3310.”
It reads the story and its comments and sums up what was decided.
“Set up a two-week sprint starting Monday.”
It creates an iteration with a name, start date and end date.

135 tools for Shortcut

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_story_commentChanges dataAdd a comment with `text` (Markdown) to a story by `story_public_id`.
add_story_taskChanges dataAdd a checklist task with `description` to a story by `story_public_id`; optional owner_ids.
archive_entity_templateDeletesDisable a entity template. Destructive action; may require approval. API summary: Disable Story Templates.
archive_iterationDeletesDisable a iteration. Destructive action; may require approval. API summary: Disable Iterations.
attach_epic_to_documentChanges dataAttach a epic (epic public id). API summary: Link Document to Epic.
create_bulkVisible to othersCreate a new bulk. Required: stories. Has effects visible outside this system. API summary: Create Multiple Stories.
create_categoryChanges dataCreate a new category. Required: name. API summary: Create Category.
create_documentChanges dataCreate a new document. Required: title or content. Search documents first to avoid duplicates. API summary: Create Doc.
create_entity_templateChanges dataCreate a new entity template. Required: name or story contents. API summary: Create Entity Template.
create_epicChanges dataCreate an epic with a `name`; optional description, epic_state_id, owner_ids, group_ids, labels, deadline and objective_ids.
create_epic_healthChanges dataCreate a new health for a epic. Required: status. API summary: Create Epic Health.
create_epic_messageChanges dataCreate a new message for a epic. Required: text. API summary: Create Epic Comment.
create_from_templateChanges dataCreate a new from template. Required: body. API summary: Create Story From Template.
create_groupChanges dataCreate a new group. Required: mention name or name. API summary: Create Group.
create_iterationChanges dataCreate an iteration (sprint) with `name`, `start_date` and `end_date`; optional description and team group_ids.
create_labelChanges dataCreate a new label. Required: name. API summary: Create Label.
create_linked_fileChanges dataCreate a new document. Required: name, type or url. Search documents first to avoid duplicates. API summary: Create Linked File.
create_message_reactionChanges dataCreate a new reaction for a message. Required: emoji. API summary: Create Story Reaction.
create_objectiveChanges dataCreate a new objective. Required: name. Search objectives first to avoid duplicates. API summary: Create Objective.
create_objective_healthChanges dataCreate a new health for a objective. Required: status. API summary: Create Objective Health.
create_projectChanges dataCreate a new project. Required: name or team id. API summary: Create Project.
create_storyChanges dataCreate a story with a `name`; optional description, story_type (feature, bug, chore), workflow_state_id, epic_id, iteration_id, group_id, owner_ids, labels, estimate and deadline.
create_story_linkChanges dataCreate a new story link. Required: verb, subject id or object id. API summary: Create Story Link.
create_webhookDeletesCreate a new webhook. Required: webhook url. Destructive action; may require approval. API summary: Create Generic Integration.
delete_bulksMoves moneyPermanently delete a bulk. Financial or irreversible action; may require approval. API summary: Delete Multiple Stories.
delete_categoryDeletesPermanently delete a category by category public id. Destructive action; may require approval. API summary: Delete Category.
delete_custom_fieldDeletesPermanently delete a custom field by custom field public id. Destructive action; may require approval. API summary: Delete Custom Field.
delete_documentDeletesPermanently delete a document by doc public id. Destructive action; may require approval. API summary: Delete Doc.
delete_entity_templateDeletesPermanently delete a entity template by entity template public id. Destructive action; may require approval. API summary: Delete Entity Template.
delete_epicDeletesPermanently delete a epic by epic public id. Destructive action; may require approval. API summary: Delete Epic.
delete_epic_messageDeletesPermanently delete a message by message public id. Destructive action; may require approval. API summary: Delete Epic Comment.
delete_fileDeletesPermanently delete a document by document public id. Destructive action; may require approval. API summary: Delete File.
delete_iterationDeletesPermanently delete a iteration by iteration public id. Destructive action; may require approval. API summary: Delete Iteration.
delete_labelDeletesPermanently delete a label by label public id. Destructive action; may require approval. API summary: Delete Label.
delete_linked_fileDeletesPermanently delete a document by document public id. Destructive action; may require approval. API summary: Delete Linked File.
delete_message_reactionsMoves moneyPermanently delete a reaction by comment public id. Financial or irreversible action; may require approval. API summary: Delete Story Reaction.
delete_objectiveDeletesPermanently delete a objective by objective public id. Destructive action; may require approval. API summary: Delete Objective.
delete_projectDeletesPermanently delete a project by project public id. Destructive action; may require approval. API summary: Delete Project.
delete_storyDeletesPermanently delete a story by `story_public_id`. This cannot be undone; archiving via update_story is usually better.
delete_story_linkDeletesPermanently delete a story link by story link public id. Destructive action; may require approval. API summary: Delete Story Link.
delete_story_messageDeletesPermanently delete a message by message public id. Destructive action; may require approval. API summary: Delete Story Comment.
delete_story_taskDeletesPermanently delete a task by task public id. Destructive action; may require approval. API summary: Delete Task.
delete_webhookDeletesPermanently delete a webhook by integration public id. Destructive action; may require approval. API summary: Delete Generic Integration.
detach_epic_to_documentDeletesDetach a epic (epic public id). Destructive action; may require approval. API summary: Unlink Document from Epic.
detach_message_from_slackChanges dataUnlink a message (comment public id). API summary: Unlink Comment thread from Slack.
filter_storiesChanges dataFind stories by exact filters: epic_id, iteration_id, group_id, owner_id, label_name, story_type, workflow_state_id, archived, or created/updated/completed date ranges.
get_categoryGet one category by category public id. API summary: Get Category.
get_current_memberGet the member the API token belongs to (you), with ID, name and workspace.
get_custom_fieldGet one custom field by custom field public id. API summary: Get Custom Field.
get_documentGet one document by doc public id. API summary: Get Doc.
get_entity_templateGet one entity template by entity template public id. API summary: Get Entity Template.
get_epicGet one epic by `epic_public_id`, with description, state, owners and progress stats.
get_epic_messageGet one message for a epic by message public id. API summary: Get Epic Comment.
get_fileGet one document by document public id. API summary: Get File.
get_groupGet one group by group public id. API summary: Get Group.
get_iterationGet one iteration by `iteration_public_id`, with dates and progress stats.
get_key_resultGet one key result by key result public id. API summary: Get Key Result.
get_labelGet one label by label public id. API summary: Get Label.
get_linked_fileGet one document by document public id. API summary: Get Linked File.
get_objectiveGet one objective by objective public id. API summary: Get Objective.
get_projectGet one project by project public id. API summary: Get Project.
get_repositoryGet one repository by repo public id. API summary: Get Repository.
get_storyGet one story by `story_public_id` (its number), with description, owners, state, tasks, comments and links.
get_story_linkGet one story link by story link public id. API summary: Get Story Link.
get_story_messageGet one message for a story by message public id. API summary: Get Story Comment.
get_story_taskGet one task for a story by task public id. API summary: Get Task.
get_userGet one user by user public id. API summary: Get Member.
get_webhookGet one webhook by integration public id. API summary: Get Generic Integration.
get_workflowGet one workflow by workflow public id. API summary: Get Workflow.
list_categoriesList categories.
list_category_milestonesList milestones for a category. API summary: List Category Milestones.
list_category_objectivesList objectives for a category. API summary: List Category Objectives.
list_custom_fieldsList custom fields.
list_document_epicsList epics for a document. API summary: List Document Epics.
list_documentsList documents. API summary: List Docs.
list_entity_templatesList entity templates.
list_epic_documentsList documents for a epic. API summary: List Epic Documents.
list_epic_health_historiesList health histories for a epic. API summary: List Epic Healths.
list_epic_healthsList healths for a epic. API summary: Get Epic Health.
list_epic_messagesList messages for a epic. API summary: List Epic Comments.
list_epic_storiesList the stories in an epic by `epic_public_id`.
list_epic_workflowsList epic workflows. API summary: Get Epic Workflow.
list_epicsList all epics with their state and IDs.
list_filesList documents. API summary: List Files.
list_iteration_storiesList the stories in an iteration by `iteration_public_id`.
list_iterationsList iterations (sprints) with their dates and status.
list_label_epicsList epics for a label. API summary: List Label Epics.
list_label_storiesList stories for a label. Optional filters: includes description. API summary: List Label Stories.
list_labelsList labels with their IDs and colors.
list_linked_filesList documents. API summary: List Linked Files.
list_membersList the members of the workspace with their IDs, names and roles.
list_objective_epicsList epics for a objective. API summary: List Objective Epics.
list_objective_health_historiesList health histories for a objective. API summary: List Objective Healths.
list_objective_healthsList healths for a objective. API summary: Get Objective Health.
list_objectivesList objectives.
list_paginatedsList paginateds. Optional filters: includes description. Results are paginated. API summary: List Epics Paginated.
list_project_storiesList stories for a project. Optional filters: includes description.
list_projectsList projects.
list_repositoriesList repositories.
list_storiesList stories. Optional filters: external link. API summary: Get External Link Stories.
list_story_commentsList the comments on a story by `story_public_id`.
list_story_historiesList histories for a story. API summary: Story History.
list_story_tasksList tasks for a story. API summary: List Story Sub tasks.
list_team_storiesList the stories owned by a team by `group_public_id`, with limit and offset.
list_teamsList teams (groups) with their IDs and members.
list_workflowsList workflows and their states (e.g. Unstarted, In Progress, Done) with IDs; use a state ID to move a story.
restore_entity_templateVisible to othersEnable a entity template. Has effects visible outside this system. API summary: Enable Story Templates.
restore_iterationVisible to othersEnable a iteration. Has effects visible outside this system. API summary: Enable Iterations.
search_documentsSearch documents by title, archived, created by me or followed by me. Use this to find existing documents before creating a new document. Results are paginated.
search_epicsSearch epics with Shortcut search syntax in `query`.
search_iterationsSearch iterations by query, detail or entity types. Use this to find existing iterations before creating a new iteration. Results are paginated.
search_milestonesSearch milestones by query, detail or entity types. Use this to find existing milestones before creating a new milestone. Results are paginated.
search_objectivesSearch objectives by query, detail or entity types. Use this to find existing objectives before creating a new objective. Results are paginated.
search_searchesSearch searches by query, detail or entity types. Use this to find existing searches before creating a new search. Results are paginated.
search_storiesSearch stories with Shortcut search syntax in `query`, e.g. "owner:jane state:\"In Progress\" login bug".
update_bulksVisible to othersUpdate an existing bulk. Has effects visible outside this system. API summary: Update Multiple Stories.
update_categoryChanges dataUpdate an existing category identified by category public id. API summary: Update Category.
update_custom_fieldChanges dataUpdate an existing custom field identified by custom field public id. API summary: Update Custom Field.
update_documentChanges dataUpdate an existing document identified by doc public id. API summary: Update Doc.
update_entity_templateChanges dataUpdate an existing entity template identified by entity template public id. API summary: Update Entity Template.
update_epicChanges dataUpdate an epic by `epic_public_id`: name, description, state, owners, teams, labels, deadline or archived.
update_epic_messageChanges dataUpdate an existing message identified by message public id. API summary: Update Epic Comment.
update_fileChanges dataUpdate an existing document identified by document public id. API summary: Update File.
update_groupChanges dataUpdate an existing group identified by group public id. API summary: Update Group.
update_healthChanges dataUpdate an existing health identified by health public id. API summary: Update Health.
update_iterationChanges dataUpdate an existing iteration identified by iteration public id. API summary: Update Iteration.
update_key_resultChanges dataUpdate an existing key result identified by key result public id. API summary: Update Key Result.
update_labelChanges dataUpdate an existing label identified by label public id. API summary: Update Label.
update_linked_fileChanges dataUpdate an existing document identified by document public id. API summary: Update Linked File.
update_objectiveChanges dataUpdate an existing objective identified by objective public id. API summary: Update Objective.
update_projectChanges dataUpdate an existing project identified by project public id. API summary: Update Project.
update_storyChanges dataUpdate a story by `story_public_id`: name, description, workflow_state_id (to move it), owners, epic, iteration, team, labels, estimate, deadline or archived. Only fields you pass change.
update_story_linkChanges dataUpdate an existing story link identified by story link public id. API summary: Update Story Link.
update_story_messageChanges dataUpdate an existing message identified by message public id. API summary: Update Story Comment.
update_story_taskChanges dataUpdate a story checklist task by `story_public_id` and `task_public_id`: description, owners or complete true/false.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Shortcut from the app list.
2
Paste your key
Paste a Shortcut API token. In Shortcut open Settings > Your Account > API Tokens (app.shortcut.com/settings/account/api-tokens), generate a token and copy it. The token has full access to your Shortcut account, so use the tool switches in HeyMyApps to limit what the AI can do.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Shortcut?

The AI can search and read stories, comments, epics, iterations, teams, members, labels and workflows. It can create and update stories, epics and iterations, add comments and checklist tasks, and move stories between workflow states. It can also delete a story if you switch that tool on.

Does the AI see my Shortcut API token?

No. Your Shortcut credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Deleting a story is permanent and cannot be undone, so archiving it is usually better. Deleting and other changes can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Shortcut account.

Can the AI use Shortcut search syntax?

Yes. The search tools take Shortcut's own search syntax, for example owner:jane state:"In Progress" login bug. For exact matches the AI can also filter stories by epic, iteration, team, owner, label, type, workflow state or dates.