Shortcut MCP server

Connect Shortcut to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy ShortcutBook a demo

What you can do with the Shortcut MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list teams tool in Shortcut
  • Use the search stories tool in Shortcut
  • Use the list objectives tool in Shortcut
  • Use the update objective tool in Shortcut
  • Use the get epic tool in Shortcut
  • Use the create objective tool in Shortcut

Supported Tools

list_teams

List Teams

Lists all teams (called "groups" in the API) in the workspace. Use this to look up team UUIDs for assigning stories, epics, or iterations to teams.

search_stories

Search Stories

Searches for stories using Shortcut's query syntax. Supports operators like `state:`, `owner:`, `label:`, `epic:`, `iteration:`, `type:`, `is:started`, `is:completed`, `is:blocked`, `is:archived`, `estimate:`, `created:`, `updated:`, and free text.

list_objectives

List Objectives

Lists all objectives (formerly milestones) in the workspace. Objectives are top-level strategic goals that epics can be linked to.

update_objective

Update Objective

Updates an existing objective's name, description, state, or categories.

get_epic

Get Epic

Retrieves full details of an epic by its ID, including description, stats, labels, owners, linked objectives, and workflow state.

create_objective

Create Objective

Creates a new objective (formerly milestone) in Shortcut. Objectives are top-level strategic goals that connect day-to-day work to broader outcomes. They can be in "to do", "in progress", or "done" states.

list_members

List Members

Lists all members of the workspace. Use this to look up member UUIDs for assigning owners, followers, or requested-by fields on stories and epics.

manage_labels

Manage Labels

Create, update, or delete labels. Labels are used to organize and filter stories and epics.

create_iteration

Create Iteration

Creates a new iteration (sprint) in Shortcut. Iterations are time-boxed periods of development with a start and end date. Stories can be assigned to iterations for sprint planning.

update_epic

Update Epic

Updates an existing epic's attributes including name, description, state, owners, teams, objectives, labels, deadlines, and archived status. Pass `null` to unset optional fields like deadline or planned start date.

delete_story

Delete Story

Permanently deletes a story by its public ID. This action cannot be undone.

create_document

Create Document

Creates a new document (Doc) in Shortcut. Docs are used for long-form documentation like design documents, product strategies, and technical specs. Content can be in Markdown or HTML format.

manage_story_comments

Manage Story Comments

Create, update, or delete comments on a story. Use the `action` field to specify the operation. When creating, provide the comment text. When updating, provide the comment ID and new text. When deleting, provide the comment ID.

list_custom_fields

List Custom Fields

Lists all custom field definitions in the workspace. Custom fields allow organizing stories by Priority, Severity, Technical Area, and more. Returns field IDs and their possible values, which are needed when setting custom fields on stories.

list_workflows

List Workflows

Lists all workflows and their states in the workspace. Workflows define the progression of stories through states (e.g., Unstarted → In Progress → Done). Use this to look up workflow state IDs needed for creating or updating stories.

get_story

Get Story

Retrieves full details of a story by its public ID, including description, comments, tasks (checklists), labels, custom fields, relationships, and workflow state.

list_epics

List Epics

Lists all epics in the workspace with their status, stats, and metadata.

update_iteration

Update Iteration

Updates an existing iteration's attributes including name, dates, description, teams, followers, and labels.

delete_epic

Delete Epic

Permanently deletes an epic by its ID. Stories within the epic are not deleted, but will no longer be associated with the epic. This action cannot be undone.

manage_story_tasks

Manage Story Tasks

Create, update, or delete checklist tasks on a story. Tasks are sub-items within a story that can be individually assigned and completed. Use the `action` field to specify the operation.

create_epic

Create Epic

Creates a new epic in Shortcut. Epics represent larger bodies of work or features composed of multiple stories. They can be assigned to teams, objectives, and have their own workflow states and deadlines.

update_document

Update Document

Updates a document's title or content by UUID. Call list_documents to discover accessible document UUIDs. Specify contentFormat when sending Markdown.

update_story

Update Story

Updates an existing story's attributes. You can change the name, description, type, workflow state, epic, iteration, team, owners, labels, estimate, deadline, custom fields, and archived status. Pass `null` to unset optional fields like estimate, deadline, epicId, or iterationId.

create_story

Create Story

Creates a new story in Shortcut. Stories are the fundamental unit of work and can be of type Feature, Bug, or Chore. You can assign the story to an epic, iteration, team, workflow state, and set owners, labels, estimates, deadlines, and custom fields.

list_iterations

List Iterations

Lists all iterations (sprints) in the workspace with their status, dates, and statistics.

list_labels

List Labels

Lists all labels in the workspace. Labels can be applied to stories and epics for organization and filtering.

get_document

Get Document

Retrieves a document's content by UUID. Call list_documents to discover accessible document UUIDs.

get_current_member

Get Current Member

Retrieves the authenticated member and their current workspace, role, and default workflow.

list_story_comments

List Story Comments

Lists story comments with their IDs, authors, timestamps, and thread relationships. Use the comment IDs with manage_story_comments.

list_documents

List Documents

Lists documents the authenticated member can read. Use the returned documentUuid with get_document or update_document.

Connect Shortcut to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Shortcut in Metorial. In your Metorial portal, enable the Shortcut MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Shortcut tools.

Run Shortcut through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Shortcut and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Shortcut tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Shortcut

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Technical notes for Shortcut

Create, read, update, delete, and search stories and epics. Plan iterations, manage objectives, labels, comments, and checklists, create and edit documents, and discover workspace members, teams, workflows, and custom fields.

Frequently asked questions

Common questions about connecting Shortcut to AI agents with Metorial.

  1. How many tools does the Shortcut MCP server have?
    The Shortcut MCP server exposes 30 tools, including List Teams, Search Stories, List Objectives. Each one is governed and traced through Metorial.
  2. Shortcut exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Shortcut MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Shortcut and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Shortcut MCP server yourself or use the hosted gateway.

Connect Shortcut to production AI agents

See how Metorial gives your team governed access to Shortcut, with tracing and security controls built in.

Book a demoDeploy Shortcut