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.

26 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.
create_epicChanges dataCreate an epic with a `name`; optional description, epic_state_id, owner_ids, group_ids, labels, deadline and objective_ids.
create_iterationChanges dataCreate an iteration (sprint) with `name`, `start_date` and `end_date`; optional description and team group_ids.
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.
delete_storyDeletesPermanently delete a story by `story_public_id`. This cannot be undone; archiving via update_story is usually better.
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_current_memberGet the member the API token belongs to (you), with ID, name and workspace.
get_epicGet one epic by `epic_public_id`, with description, state, owners and progress stats.
get_iterationGet one iteration by `iteration_public_id`, with dates and progress stats.
get_storyGet one story by `story_public_id` (its number), with description, owners, state, tasks, comments and links.
list_epic_storiesList the stories in an epic by `epic_public_id`.
list_epicsList all epics with their state and IDs.
list_iteration_storiesList the stories in an iteration by `iteration_public_id`.
list_iterationsList iterations (sprints) with their dates and status.
list_labelsList labels with their IDs and colors.
list_membersList the members of the workspace with their IDs, names and roles.
list_story_commentsList the comments on a story by `story_public_id`.
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.
search_epicsSearch epics with Shortcut search syntax in `query`.
search_storiesSearch stories with Shortcut search syntax in `query`, e.g. "owner:jane state:\"In Progress\" login bug".
update_epicChanges dataUpdate an epic by `epic_public_id`: name, description, state, owners, teams, labels, deadline or archived.
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_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 PipMCP 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 PipMCP 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 PipMCP 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?

PipMCP 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.