What can you do with this server?

The Shortcut MCP Server provides comprehensive programmatic access to the Shortcut project management tool via the Model Context Protocol (MCP). With this server, you can: * Story Management: Get, search, create, and update stories; assign/unassign owners; add comments and tasks; manage external links; generate valid branch names; and handle story relationships (blocking, duplicates) * Iteration Management: Get, search, and create iterations; retrieve stories within iterations; list active or upcoming iterations * Epic Management: Get, search, and create epics * Objective Management: Get and search objectives by various criteria * Team & Workflow Management: Get specific teams or workflows; list all teams or workflows * User Information: Get current user details and list all members

Which integrations are available for this server?

Provides integration with Shortcut's project management platform, allowing AI assistants to interact with Shortcut data using an API token for authentication. Mentioned as a support channel for troubleshooting issues with the MCP server through the Shortcut community Slack.

How do I use Shortcut MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Shortcut MCP Server search for stories assigned to me that are in progress" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

Shortcut MCP Server

Official

by useshortcut

Overview Schema Related Servers Score Discussions

TypeScript

Remote

:warning: Future work for the Shortcut MCP server will be done for the remote server at https://mcp.shortcut.com/mcp. Instructions for installing and using the server can be found here: Shortcut MCP Server.

@shortcut/mcp

Version Monthly Downloads GitHub License PRs welcome!

MCP Server for Shortcut users.

Links: Local Installations | Server Developers | Tool Registration

Usage

Cursor

The fastest way to get started is to connect to Shortcut's hosted MCP server. No API token or local setup required — authentication is handled via OAuth.

Open (or create) the mcp.json file (it should be in ~/.cursor/mcp.json or <project-root>/.cursor/mcp.json, but see Cursor docs for more details).
Add the following details and save the file:

{
  "mcpServers": {
    "shortcut": {
      "url": "https://mcp.shortcut.com/mcp"
    }
  }
}

Restart Cursor. You will be prompted to authorize with your Shortcut account on first use.

VS Code

If all you need need the configuration for the mcp.json file use this. You will be prompted to authorize with your Shortcut account on first use.

{
  "servers": {
    "shortcut-mcp": {
      "type": "http",
      "url": "https://mcp.shortcut.com/mcp"
    }
  }
}

For more detail on installing MCP services in VSCode see the official VS Code MCP docs for more information.

Claude Desktop

Download the package from this repo

Then, either double-click the icon to install or drag the package onto the client window. It should trigger the installation.

Other IDEs / Running Locally

If your IDE doesn't support HTTP-based MCP servers, or you'd prefer to run the server locally, see the Local Server Setup guide. This covers setup for Windsurf, Zed, Claude Code, and any IDE that supports stdio-based MCP servers.

Related MCP server: MCP Starter

Available Tools

Stories

Tool	Description
`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 (based on workspace settings) for a specific 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 (relates to, blocks, duplicates, etc.)
`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 with a new set of links
`stories-get-by-external-link`	Find all stories that contain a specific external link

Labels

Tool	Description
`labels-list`	List all labels in the Shortcut workspace
`labels-get-stories`	Get all stories with a specific label
`labels-create`	Create a new label in Shortcut

Custom Fields

Tool	Description
`custom-fields-list`	List all custom fields in the workspace with their possible values

Epics

Tool	Description
`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
`epics-create-comment`	Create a comment on an epic

Iterations

Tool	Description
`iterations-get-stories`	Get stories in a specific iteration by iteration ID
`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/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 based on team memberships
`iterations-get-upcoming`	Get upcoming iterations for the current user based on team memberships

Objectives

Tool	Description
`objectives-get-by-id`	Get a Shortcut objective by ID
`objectives-search`	Find Shortcut objectives with filtering and search options

Teams

Tool	Description
`teams-get-by-id`	Get a Shortcut team by ID
`teams-list`	List all Shortcut teams

Projects

Tool	Description
`projects-list`	List all projects in the Shortcut workspace
`projects-get-by-id`	Get a Shortcut project by public ID
`projects-get-stories`	Get all stories in a specific project

Workflows

Tool	Description
`workflows-get-default`	Get the default workflow for a specific team or the workspace default
`workflows-get-by-id`	Get a Shortcut workflow by ID
`workflows-list`	List all Shortcut workflows

Users

Tool	Description
`users-get-current`	Get the current user information
`users-get-current-teams`	Get a list of teams where the current user is a member
`users-list`	Get all workspace users

Documents

Tool	Description
`documents-create`	Create a new document in Shortcut with Markdown content
`documents-update`	Update content of an existing document by its ID
`documents-list`	List all documents in Shortcut
`documents-search`	Search for documents
`documents-get-by-id`	Retrieve a specific document in markdown format by its ID

Limit tools

You can limit the tools available to the LLM by setting the SHORTCUT_TOOLS environment variable to a comma-separated list.

Tools can be limited by entity type by just adding the entity, eg stories or epics.
Individual tools can also be limitied by their full name, eg stories-get-by-id or epics-search.

By default, all tools are enabled.

Example (when running locally):

{
  "mcpServers": {
    "shortcut": {
      "command": "npx",
      "args": ["-y", "@shortcut/mcp@latest"],
      "env": {
        "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>",
        "SHORTCUT_TOOLS": "stories,epics,iterations-create"
      }
    }
  }
}

The following values are accepted in addition to the full tool names listed above under Available Tools:

users
stories
epics
iterations
labels
custom-fields
objectives
teams
projects
workflows
documents

Read-only mode

You can run the MCP server in read-only mode by setting the SHORTCUT_READONLY environment variable to true. This will disable all tools that modify data in Shortcut.

Example (when running locally):

{
  "mcpServers": {
    "shortcut": {
      "command": "npx",
      "args": ["-y", "@shortcut/mcp@latest"],
      "env": {
        "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>",
        "SHORTCUT_READONLY": "true"
      }
    }
  }
}

Issues and Troubleshooting

Before doing anything else, please make sure you are running the latest version!

If you run into problems using this MCP server, you have a couple of options:

Option	Link
Open an issue	GitHub
Ask for help	Slack

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

17dResponse time

1wRelease cycle

38Releases (12mo)

Issues opened vs closed

Resources

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Appeared in Searches

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/useshortcut/mcp-server-shortcut'

If you have feedback or need assistance with the MCP directory API, please join our Discord server