Shortcut
A Model Context Protocol server that enables interaction with Shortcut (formerly Clubhouse) project management tool, allowing users to view and search projects, stories, epics, and objectives, as well as create new items through natural language.
What is Shortcut?
Shortcut is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that enables interaction with shortcut (formerly clubhouse) project management tool, allowing users to view and search projects, stories, epics, and objectives, as well a...
A Model Context Protocol server that enables interaction with Shortcut (formerly Clubhouse) project management tool, allowing users to view and search projects, stories, epics, and objectives, as well as create new items through natural language.
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that enables interaction wit
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @shortcut/mcpManual Installation
npx -y @shortcut/mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Shortcut
The Shortcut MCP Server connects AI assistants to Shortcut (formerly Clubhouse), a project management platform popular with engineering teams. It exposes over 50 tools covering stories, epics, iterations, objectives, labels, workflows, teams, projects, documents, and users — enabling you to search, create, update, and link work items entirely through natural language. Product managers and engineers use it to manage sprint work, triage bugs, and draft documentation without leaving their AI chat interface.
Prerequisites
- A Shortcut account with an active workspace
- A Shortcut API token (generated in Shortcut Settings > API Tokens)
- Node.js 18 or later (for local/stdio mode)
- An MCP-compatible client such as Claude Desktop, Cursor, VS Code, or Windsurf
Obtain a Shortcut API token
Log in to Shortcut, go to Settings > API Tokens, and generate a new personal API token. Copy it — you will need it in the configuration step.
Choose hosted or local mode
Shortcut now maintains a hosted remote MCP server at https://mcp.shortcut.com/mcp with OAuth authentication — no API token or local setup required. For clients that require stdio (Claude Code, Windsurf, Zed), run the package locally via npx instead.
Configure for hosted mode (Cursor / VS Code)
For Cursor, add to ~/.cursor/mcp.json. For VS Code add to your mcp.json as an http-type server. You will be prompted to authorize via OAuth on first use.
{
"mcpServers": {
"shortcut": {
"url": "https://mcp.shortcut.com/mcp"
}
}
}Configure for local/stdio mode (Claude Desktop, Claude Code)
For clients requiring stdio transport, run the npm package locally and supply your API token. Optionally set SHORTCUT_TOOLS to restrict which tool groups are enabled.
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": ["-y", "@shortcut/mcp@latest"],
"env": {
"SHORTCUT_API_TOKEN": "your-shortcut-api-token",
"SHORTCUT_TOOLS": "stories,epics,iterations"
}
}
}
}Restart your client and verify
Restart your MCP client. The Shortcut tools should appear. Ask your AI assistant to list your current stories or fetch a specific story by ID to verify the connection.
Shortcut Examples
Client configuration
Local stdio configuration for Claude Desktop using the @shortcut/mcp npm package with an API token.
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": ["-y", "@shortcut/mcp@latest"],
"env": {
"SHORTCUT_API_TOKEN": "your-shortcut-api-token"
}
}
}
}Prompts to try
Sample prompts covering the main capabilities: searching stories, creating work items, managing epics, and checking iteration status.
- "Search for all open stories assigned to me in the current iteration"
- "Create a new story called 'Fix login timeout bug' in the Backend project with high priority"
- "Show me all epics that are currently in progress"
- "Get the details and comments for story sc-1234"
- "List all active iterations for the mobile team"
- "Assign story sc-5678 to me and move it to In Progress"Troubleshooting Shortcut
Authentication errors or '401 Unauthorized' responses
Verify that SHORTCUT_API_TOKEN is set to a valid, active token. Tokens are workspace-scoped — ensure the token belongs to the workspace you are targeting. Regenerate a token in Shortcut Settings > API Tokens if needed.
Too many tools overwhelm the model context window
Use the SHORTCUT_TOOLS environment variable to restrict available tools to only the entity types you need, for example 'SHORTCUT_TOOLS=stories,epics'. Individual tools can also be specified by full name like 'stories-get-by-id'.
Hosted OAuth flow fails or loops
Ensure your client supports HTTP-based MCP servers. Cursor and VS Code support this natively. For stdio-only clients (Claude Desktop, Windsurf, Zed), switch to the local npx configuration with a personal API token instead of the hosted URL.
Frequently Asked Questions about Shortcut
What is Shortcut?
Shortcut is a Model Context Protocol (MCP) server that model context protocol server that enables interaction with shortcut (formerly clubhouse) project management tool, allowing users to view and search projects, stories, epics, and objectives, as well as create new items through natural language. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Shortcut?
Install via npm with the command: npx -y @shortcut/mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Shortcut?
Shortcut works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Shortcut free to use?
Yes, Shortcut is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Shortcut Alternatives — Similar Business Applications Servers
Looking for alternatives to Shortcut? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Shortcut in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Shortcut?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.