Connect
Optimize
Secure
Shortcut MCP Server
for AI Agents
Production-ready Shortcut MCP server with 78 extensible actions — plus built-in authentication, security, and optimized execution.
Shortcut MCP Server
Built by 
StackOne
StackOne 
Coverage
78 Agent Actions
Create, read, update, and delete across Shortcut — and extend your agent's capabilities with custom actions.
Authentication
Agent Tool Authentication
Per-user OAuth in one call. Your Shortcut MCP server gets session-scoped tokens with zero credentials stored on your infra.
Agent Auth →
Security
Agent Protection
Every Shortcut tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.
Prompt Injection Defense →
Performance
Max Agent Context. Min Cost.
Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every Shortcut call.
Tools Discovery →What is the Shortcut MCP Server?
A Shortcut MCP server lets AI agents read and write Shortcut data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's Shortcut MCP server ships with 78 pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, and optimized agent context. Connect it from MCP clients like Claude Desktop, Cursor, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.
All Shortcut MCP Tools and Actions
Every action from Shortcut's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.
Categorys
- Create Category
Create a new category in Shortcut
- Get Category
Retrieve a specific category by its public ID
- Update Category
Update an existing category in Shortcut
- Delete Category
Delete a category from Shortcut
Custom Fields
- List Custom Fields
List all custom fields in the workspace
- Get Custom Field
Retrieve a specific custom field by its public ID
Documents
- Create Document
Create a new document in Shortcut
- List Documents
List all documents in the Shortcut workspace
- Get Document
Retrieve a specific document by its public ID
- Update Document
Update an existing document in Shortcut
- Delete Document
Delete a document from Shortcut
Epic Comments
- Create Epic Comment
Create a new comment on an epic
- List Epic Comments
List all comments on an epic
- Get Epic Comment
Retrieve a specific comment on an epic
- Delete Epic Comment
Delete a comment from an epic
Epics
- Create Epic
Create a new epic in Shortcut
- List Epics
List all epics in the Shortcut workspace
- Get Epic
Retrieve a specific epic by its public ID
- Search Epics
Search for epics using a text query
- Update Epic
Update an existing epic in Shortcut
- Delete Epic
Delete an epic from Shortcut
Groups
- Create Group
Create a new group in Shortcut
- List Groups
List all groups in the Shortcut workspace
- Get Group
Retrieve a specific group by its public ID
- Update Group
Update an existing group in Shortcut
Iterations
- Create Iteration
Create a new iteration in Shortcut
- List Iterations
List all iterations in the Shortcut workspace
- Get Iteration
Retrieve a specific iteration by its public ID
- Update Iteration
Update an existing iteration in Shortcut
- Delete Iteration
Delete an iteration from Shortcut
Labels
- Create Label
Create a new label in Shortcut
- List Labels
List all labels in the Shortcut workspace
- Get Label
Retrieve a specific label by its public ID
- Update Label
Update an existing label in Shortcut
- Delete Label
Delete a label from Shortcut
Members
- List Members
List all members in the Shortcut workspace
- Get Member
Retrieve a specific member by their public ID
Objectives
- Create Objective
Create a new objective in Shortcut
- List Objectives
List all objectives in the workspace
- Get Objective
Retrieve a specific objective by its public ID
- Update Objective
Update an existing objective in Shortcut
- Delete Objective
Delete an objective from Shortcut
Projects
- Create Project
Create a new project in Shortcut
- List Projects
List all projects in the Shortcut workspace
- Get Project
Retrieve a specific project by its public ID
- Update Project
Update an existing project in Shortcut
- Delete Project
Delete a project from Shortcut
Stories
- Search Stories
Search for stories using a text query
- Query Stories
Search for stories using filter criteria
Storys
- Create Story
Create a new story in Shortcut
- Get Story
Retrieve a specific story by its public ID
- Update Story
Update an existing story in Shortcut
- Delete Story
Delete a story from Shortcut
Story Comments
- Create Story Comment
Add a new comment to a story
- List Story Comments
List all comments on a story
- Get Story Comment
Retrieve a specific comment on a story
- Update Story Comment
Update an existing comment on a story
- Delete Story Comment
Delete a comment from a story
Story Links
- Create Story Link
Create a relationship between two stories
- Get Story Link
Retrieve a specific story link
- Update Story Link
Update an existing story link
- Delete Story Link
Delete a story link
Story Tasks
- Create Story Task
Add a new task to a story
- Get Story Task
Retrieve a specific task on a story
- Update Story Task
Update an existing task on a story
- Delete Story Task
Delete a task from a story
Workflows
- List Workflows
List all workflows in the Shortcut workspace
- Get Workflow
Retrieve a specific workflow by its public ID
Other (10)
- List Categories
List all categories in the workspace
- List Epic Stories
List all stories belonging to an epic
- Get Epic Health
Retrieve the current health status of an epic
- Get Epic Workflow
Retrieve the epic workflow and its states
- List Group Stories
List all stories associated with a specific group
- List Iteration Stories
List all stories in a specific iteration
- Get Current Member
Retrieve the currently authenticated member
- List Project Stories
List all stories associated with a specific project
- Get Story History
Retrieve the history of changes for a story
- List Story Sub Tasks
List all sub-task stories for a given story
Set Up Your Shortcut MCP Server in Minutes
One endpoint. Any framework. Your agent is talking to Shortcut in under 10 lines of code.
MCP Clients
Agent Frameworks
JSON{
"mcpServers": {
"stackone": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.stackone.com/mcp?x-account-id=<account_id>",
"--header",
"Authorization: Basic <YOUR_BASE64_TOKEN>"
]
}
}
}More Project Management MCP Servers
Azure DevOps
172+ actions
Bitbucket
134+ actions
Jira
134+ actions
Confluence
133+ actions
Trello
133+ actions
Asana
126+ actions
GitLab
125+ actions
Shortcut MCP Server Resources
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
Indirect Prompt Injection Defense for MCP Tools: A Technical Guide
MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.
12 min
Shortcut MCP Server FAQ
Shortcut MCP server vs direct API integration — what's the difference?
A Shortcut MCP server and direct API integration serve different use cases. Direct API integration is for software-to-software — backend code calling Shortcut. A Shortcut MCP server is for AI agents — MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI — discovering and calling Shortcut at runtime. StackOne provides both.
How does Shortcut authentication work for AI agents?
Shortcut authentication for AI agents works through a StackOne Connect Session. Create one via the dashboard or the SDK — you get an auth link and ready-to-paste config for Claude Desktop, Cursor, and other MCP clients. Your user authenticates their own Shortcut account; StackOne handles token exchange, storage, and refresh. Credentials never reach the LLM, and each user is isolated via
origin_owner_id.Are Shortcut MCP tools vulnerable to prompt injection?
Yes — Shortcut MCP tools can be vulnerable to indirect prompt injection. Any tool that reads user-written content — documents, messages, tickets, records, or free-text fields — is a potential vector. StackOne Defender scans every tool response before it enters the agent's context — regex patterns in ~1ms, then a MiniLM classifier in ~4ms. 88.7% accuracy, CPU-only.
What is the context bloat of a Shortcut agent and how do I avoid it?
Context bloat happens when Shortcut tool schemas and API responses eat your Shortcut agent's memory, preventing it from reasoning effectively. A single Shortcut query can return a massive JSON response, and connecting multiple tools compounds the problem. Tools Discovery and Code Mode reduce context bloat — loading only relevant tools per query and keeping raw responses out of the agent's context.
Can I limit which actions my Shortcut agent can access?
Yes — you can limit which actions your Shortcut agent can access directly from the StackOne dashboard. Toggle actions on or off, or restrict them to specific accounts, with no code changes to your agent. Session tokens can be scoped to exact actions so if one leaks, exposure stays contained.
Can I create custom agent actions for my Shortcut MCP server?
Yes — you can create custom agent actions for your Shortcut MCP server using Connector Builder. It's an integration agent your coding assistant (Claude Code, Cursor, or Copilot) can invoke to research Shortcut's API, generate production-ready connector YAML, test against the live API, and validate before you ship.
When should I NOT use a Shortcut MCP server?
Skip a Shortcut MCP server if your integration is purely software-to-software — direct Shortcut API integration is simpler when no AI agent is involved. For deterministic, compliance-critical operations (financial transactions, regulatory reporting), direct API gives you predictable behavior without agent-driven decision-making. MCP shines when AI agents need to dynamically discover and call Shortcut actions at runtime.
What AI frameworks and AI clients does the StackOne Shortcut MCP server support?
The StackOne Shortcut MCP server supports both. MCP clients (paste-and-go apps): Claude Desktop, Claude Code, Cursor, VS Code, Goose. Agent frameworks (code SDKs you build with): OpenAI Agents SDK, Anthropic, Vercel AI, Google ADK, CrewAI, Pydantic AI, LangChain, LangGraph, Azure AI Foundry.
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.