by useshortcut
Automate sprint planning and task management with Shortcut—supports story management, epics, teams, and more for agile d
Provides integration with Shortcut project management platform for managing stories, epics, iterations, and team workflows. Offers hosted remote connection with OAuth authentication for zero-setup use.
Shortcut is an official MCP server published by useshortcut that provides AI assistants with tools and capabilities via the Model Context Protocol. Automate sprint planning and task management with Shortcut—supports story management, epics, teams, and more for agile d It is categorized under productivity.
You can install Shortcut in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
MIT
Shortcut is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Add new capabilities to Claude beyond text generation
Example
Access external data sources, execute code, interact with tools and services
Transform Claude from chatbot to action-taking agent
Provide Claude with access to relevant context and data
Example
Load project documentation, access knowledge bases, query databases
Get more accurate, context-aware responses
Automate multi-step workflows combining AI and external tools
Example
Research → Summarize → Create document → Send notification
Complete complex tasks end-to-end without manual steps
Share your MCP server with the developer community
I recommend Shortcut for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
According to our notes, Shortcut benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
Shortcut is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
Shortcut has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
Shortcut reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
According to our notes, Shortcut benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
I recommend Shortcut for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
We wired Shortcut into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
Shortcut reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
Shortcut has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
showing 1-10 of 67
MCP Server for Shortcut users.
Links: Local Installations | Server Developers
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.
mcp.json file (it should be in ~/.cursor/mcp.json or <project-root>/.cursor/mcp.json, but see Cursor docs for more details).{
"mcpServers": {
"shortcut": {
"url": "https://mcp.shortcut.com/mcp"
}
}
}
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": {
"github-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.
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.
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.
| 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 |
| 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 |
| Tool | Description |
|---|---|
custom-fields-list | List all custom fields in the workspace with their possible values |
| 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 |
| 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 |
| Tool | Description |
|---|---|
objectives-get-by-id | Get a Shortcut objective by ID |
objectives-search | Find Shortcut objectives with filtering and search options |
| Tool | Description |
|---|---|
teams-get-by-id | Get a Shortcut team by ID |
teams-list | List all Shortcut teams |
| 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 |
| 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 |
| 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 |
| 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 |
You can limit the tools available to the LLM by setting the SHORTCUT_TOOLS environment variable to a comma-separated list.
stories or epics.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:
usersstoriesepicsiterationslabelscustom-fieldsobjectivesteamsprojectsworkflowsdocumentsYou 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"
}
}
}
}
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:
Prerequisites
Time Estimate
15-60 minutes depending on server complexity
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
Model Context Protocol standardizes how AI hosts (Claude, Cursor) communicate with external tools and data sources through server implementations.
Protocols
Compatibility
✓ Use when
Use when you need Claude to access external data, execute actions, or integrate with tools. Best for extending AI capabilities beyond conversation.
✗ Avoid when
Avoid when native integrations exist (use official APIs directly), for real-time critical systems, or when security/compliance requires zero external dependencies.