# Shortcut MCP
> Shortcut hosted MCP exposes workspace project-management entities, including Stories and Docs with create/update, plus Epic/Iteration creation and read-only workspace records.
Canonical: https://www.mcpfolio.com/servers/shortcut
Last updated: 2026-10-29
## Catalog record

- Publisher: Shortcut
- Categories: productivity

## Website

https://www.shortcut.com/help/integrations/mcp-server/

## Transports

Streamable HTTP

## Authentication

OAuth browser authorization; scopes include read, write, story-write, comment-write, and admin.

## Tools

- **stories-get-by-id**: Get a single Shortcut story by ID
- **stories-get-history**: Get the change history for a story
- **stories-search**: Find Shortcut stories with filtering and search options
- **stories-get-branch-name**: Get the recommended branch name for a story
- **stories-create**: Create a new Shortcut story
- **stories-update**: Update an existing Shortcut story
- **stories-upload-file**: Upload a file and link it to a story
- **stories-assign-current-user**: Assign the current user as the owner of a story
- **stories-unassign-current-user**: Unassign the current user as the owner of a story
- **stories-create-comment**: Create a comment on a story
- **stories-create-subtask**: Add a new sub-task to a story
- **stories-add-subtask**: Add an existing story as a sub-task
- **stories-remove-subtask**: Remove a sub-task from a story
- **stories-add-task**: Add a task to a story
- **stories-update-task**: Update a task in a story
- **stories-add-relation**: Add a story relationship
- **stories-add-external-link**: Add an external link to a Shortcut story
- **stories-remove-external-link**: Remove an external link from a Shortcut story
- **stories-set-external-links**: Replace all external links on a story
- **stories-get-by-external-link**: Find stories containing a specific external link
- **labels-list**: List all labels in the Shortcut workspace
- **labels-get-stories**: Get stories with a specific label
- **labels-create**: Create a new label in Shortcut
- **custom-fields-list**: List workspace custom fields and possible values
- **epics-get-by-id**: Get a Shortcut epic by ID
- **epics-search**: Find Shortcut epics with filtering and search options
- **epics-create**: Create a new Shortcut epic
- **epics-update**: Update an existing Shortcut epic
- **epics-delete**: Delete a Shortcut epic
- **iterations-get-stories**: Get stories in a specific iteration
- **iterations-get-by-id**: Get a Shortcut iteration by ID
- **iterations-search**: Find Shortcut iterations with filtering and search options
- **iterations-create**: Create a new Shortcut iteration with start and end dates
- **iterations-update**: Update an existing Shortcut iteration
- **iterations-delete**: Delete a Shortcut iteration
- **iterations-get-active**: Get active iterations for the current user
- **iterations-get-upcoming**: Get upcoming iterations for the current user
- **objectives-get-by-id**: Get a Shortcut objective by ID
- **objectives-search**: Find Shortcut objectives with filtering and search options
- **teams-get-by-id**: Get a Shortcut team by ID
- **teams-list**: List all Shortcut teams
- **projects-list**: List all projects in the Shortcut workspace
- **projects-get-by-id**: Get a Shortcut project by public ID
- **projects-get-stories**: Get stories in a specific project
- **workflows-get-default**: Get the default workflow for a team or workspace
- **workflows-get-by-id**: Get a Shortcut workflow by ID
- **workflows-list**: List all Shortcut workflows
- **users-get-current**: Get the current user information
- **users-get-current-teams**: List teams where the current user is a member
- **users-list**: List all workspace users
- **documents-create**: Create a new document with Markdown content
- **documents-update**: Update content of an existing document
- **documents-list**: List all documents in Shortcut
- **documents-search**: Search Shortcut documents
- **documents-get-by-id**: Retrieve a document in Markdown by ID

## Sources

- [official_documentation](https://www.shortcut.com/help/integrations/mcp-server/)
- [publisher_readme_tool_reference_via_directory](https://mcp.directory/servers/shortcut)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/shortcut) to view instructions for each supported client.