Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Shortcut in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Let your AI work in Shortcut: search stories with Shortcut's search operators, read stories with tasks, comments and history, epics, iterations, objectives, teams, workflows and labels, and create, update and comment on stories after you confirm. Personal API token.
Try asking
Example prompts for Shortcut
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Shortcut, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Shortcut
Let your AI work in Shortcut: search stories with Shortcut's search operators, read stories with tasks, comments and history, epics, iterations, objectives, teams, workflows and labels, and create, update and comment on stories after you confirm. Personal API token.
Setup
- In Shortcut, click your avatar and open Settings → Your Account → API Tokens (
https://app.shortcut.com/settings/account/api-tokens). - Enter a name such as AnythingMCP and click Generate Token. Shortcut shows the token only once.
- Paste it into
SHORTCUT_API_TOKENand install the connector. It is sent as theShortcut-Tokenheader and only to Shortcut. - Check the setup with
shortcut_get_current_member: it shows who you are, your mention name and the workspace.
The token acts as you: in the workspace it was created in, with your permissions. Stories and comments the AI writes appear under your name. If you work in several Shortcut workspaces, create one token per workspace.
Writes only after your yes: shortcut_create_story, shortcut_update_story and shortcut_add_story_comment change the workspace at once and notify followers. The AI shows you the story, the fields or the comment text first and waits for a clear yes. shortcut_delete_story is installed switched off: a deleted story cannot be restored, and archiving it with shortcut_update_story is the safer choice.
Search the way Shortcut does: shortcut_search_stories and shortcut_search_epics take Shortcut's search operators. You ask in plain words and the AI builds the query:
owner:jane,requester:jane,team:"Mobile",epic:"Checkout redesign",iteration:"Sprint 12",label:"customer",state:"In Progress",type:bug,estimate:3.is:started,is:done,is:blocked,is:overdue,has:owner,has:deadline,has:comment.- Dates:
created:2026-10-01..2026-10-15,updated:today,completed:yesterday,due:*..2026-10-31. - An exclamation mark in front of an operator excludes it, for example
owner:jane is:started !is:archived type:bug.
What it reads: stories with description, tasks, comments, links and their full change history (who moved what, and when), epics with their comments, iterations, objectives, teams, workflows with their states, labels, projects and members. To move a story the AI sets its workflow state, which it looks up first.
Paging and limits: searches return 25 results by default and up to 250 per page. Only the first 1000 matches can be paged through, so the AI narrows the query instead. 200 requests per minute per token.
Common errors: 401: the token is wrong or was deleted; generate a new one. 404: the id does not exist in this workspace. 400 or 422: a value is not accepted, for example a workflow state from another workflow; Shortcut names it in the message.
Not covered: deleting epics, iterations, labels or comments, Docs, files and attachments, editing custom fields, story templates, webhooks, tasks and story links.
Prerequisites: SHORTCUT_API_TOKEN
Install the connector locally
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Open http://localhost:3000/connectors/store, pick Shortcut and paste in the env vars listed under Prerequisites.
Available tools
| Tool | What it does |
|---|---|
shortcut_get_current_member | Read who the API token belongs to: member id (UUID), name, mention name (for owner: searches), role, and the workspace with its name, URL… |
shortcut_list_members | List the members of the workspace: id (UUID, used for owner_ids and requested_by_id), name, mention name, role and whether they are disabled |
shortcut_list_workflows | List the workflows of the workspace with their states: workflow id and name, default state, team, and each state's id, name, type… |
shortcut_list_teams | List the teams (called groups in the API): id (UUID, used as group_id), name, mention name, description, archived, workflow ids, member ids… |
shortcut_list_projects | List the projects of the workspace (an older way to group stories; many workspaces use teams instead): id, name, abbreviation, archived… |
shortcut_list_epics | List epics page by page: id, name, state (to do, in progress, done), dates, owners, teams, objectives and story counts |
shortcut_search_epics | Search epics with text and Shortcut search operators (see the connector instructions), e.g. 'checkout is:started' |
shortcut_get_epic | Read one epic: name, description, state, dates, owners, teams, objectives, labels, health and story counts, plus its comments |
shortcut_list_epic_stories | List the stories of one epic with id, name, type, state, owners, estimate and dates |
shortcut_list_iterations | List all iterations (sprints): id, name, status (unstarted, started, done), start and end date, teams and point and story counts |
shortcut_list_iteration_stories | List the stories of one iteration (sprint) with id, name, type, state, owners, estimate and dates |
shortcut_list_objectives | List objectives (the successor of milestones): id, name, state (to do, in progress, done), whether started or completed, categories and app… |
shortcut_list_labels | List the labels of the workspace: id, name, color, description and archived |
shortcut_search_stories | Search stories with text and Shortcut search operators (see the connector instructions), e.g. 'owner:jane is:started type:bug' |
shortcut_get_story | Read one story in full: name, description, type, state, epic, iteration, team, owners, requester, estimate, deadline, labels, tasks… |
shortcut_get_story_history | Read the change history of one story: each change with time, who made it (member id and name) and the actions, e.g. state moves, owner… |
shortcut_create_story | Create a story |
shortcut_update_story | Change a story: name, description, type, workflow state (to move it), team, epic, iteration, owners, estimate, deadline, labels or archived |
shortcut_add_story_comment | Add a comment to a story, as you |
shortcut_delete_story | Delete a story permanently |
Example prompts
- "What is on my plate right now? List my started stories that are not done yet, with their epic and iteration."
- "Which bugs were completed in Sprint 12, and which ones are still open?"
- "Show me the history of story 4521: who moved it to Ready for Review, and when?"
- "Create a bug story 'Checkout fails with expired card' for the Payments team, state Unstarted, owner Jane. Show me the story before you create it."
- "Comment on story 4521 that the fix is on staging, and move it to Ready for Review. Confirm with me first."
Next steps
Was this guide helpful?
