Connect Shortcut to AI agents

Connect Shortcut to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Deploy ShortcutBook a demo

Supported Tools

Tools27Triggers1

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 an existing document's title or content.

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 by its ID, including its full content.

More integrations teams use with Shortcut

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. Subscribe to real-time webhooks for changes to issues, projects, cycles, comments, documents, and more.

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. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

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.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Track issues with the built-in issue tracker. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

GitLab

Manage GitLab projects, repositories, issues, merge requests, releases, and CI/CD workflows from one provider. Includes pipeline, job, variable, environment, schedule, trigger, runner, deployment, CI lint, and test report tools.

Technical notes for Shortcut

Create, read, update, delete, and search stories, epics, objectives, and iterations for software project management. Manage workflows, teams, labels, custom fields, and documents. Assign stories to sprints, set deadlines and estimates, track workflow state changes, manage story relationships (blockers/blocked), and add comments and checklists. Upload files, link external files, and search across all work items with rich query operators. Receive webhooks for story, epic, comment, and workflow state changes.

Connect Shortcut to production AI agents

See how Metorial gives Shortcut access the governance, tracing, and security controls teams need.

Book a demoDeploy Shortcut

Frequently asked questions

Common questions about connecting Shortcut to AI agents with Metorial.

  1. Can Metorial connect Shortcut to AI agents?
    Yes. Metorial connects AI agents to Shortcut through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.