Automate sprint planning and task management with Shortcut—supports story management, epics, teams, and more for agile d
by useshortcut·Updated Apr 13, 2026Add 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
Time estimate: 15-60 minutes depending on server complexity
Prerequisites
Specif-ai
Specif-ai ensures secure web API access and robust error handling, making it a top choice among API security companies f
Excel
Unlock powerful Excel automation: read/write Excel files, create sheets, and automate workflows with seamless integratio
Asana
MCP server for Asana — enables Claude to interact with Asana data and workflows.
Spec Workflow MCP
Structured spec-driven development workflow for AI-assisted software development. Creates detailed specifications before
Monday.com
MCP server for Monday.com — enables Claude to interact with Monday.com data and workflows.
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
Share your MCP server with the developer community
Select a client to integrate this server.
Claude Desktop configuration
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "\u003CYOUR_SHORTCUT_API_TOKEN\u003E"
}
}
}
}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.
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:
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.
Coolify
Manage servers and databases with Coolify—seamless system management server and SQL server tools via natural language.