Shortcut FAQs

Question 1

What is the Shortcut MCP Server?

Accepted Answer

The Shortcut MCP Server is an implementation of the Model Context Protocol that integrates directly with the Shortcut API. It enables programmatic access and management of user-assigned epics and stories within Shortcut.

Question 2

What key actions can I perform with this tool?

Accepted Answer

You can search for users by email, retrieve all epics and stories assigned to a specific user (individually or in a single request), and filter user-owned stories based on due dates and various workflow states.

Question 3

How do I install and configure the Shortcut MCP Server?

Accepted Answer

To install, clone the repository and run `npm install`. Configuration requires your Shortcut API Token, which you'll use to set up the server within an MCP client, such as VS Code Copilot, by adding specific JSON settings.

Question 4

Can I filter user stories by their due dates or workflow status?

Accepted Answer

Yes, the server allows you to filter user-owned stories by due date criteria (e.g., before/after a specific date, between dates, or no deadline) and by an array of workflow states like 'In progress' or 'In review'.

Question 5

What are the benefits of using an MCP server for Shortcut?

Accepted Answer

It provides a standardized, efficient way to interact with the Shortcut API, streamlining project and task management workflows. This integration enhances developer productivity and facilitates automation, especially when used with AI-powered code assistants.

Shortcut

About

Key Features

Use Cases