Shortcut Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Shortcut MCP or direct API to create stories, update tasks, fetch project status, and automate team workflows through natural language.
BOOK A CALLGET STARTED FOR FREE
Shortcut Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools

Tools
Create categoryCreate category allows you to create a new category in shortcut.
Create entity templateCreate a new entity template for the workspace.
Create epicCreate epic allows you to create a new epic in shortcut.
Create epic commentThis endpoint allows you to create a threaded comment on an epic.
Create epic comment commentThis endpoint allows you to create a nested comment reply to an existing epic comment.
Create groupCreates a new group in the shortcut system with customizable properties.
Create iterationThe createiteration endpoint allows you to create a new iteration in shortcut, which represents a time-boxed period for completing a set of stories or tasks.
Create labelCreate label allows you to create a new label in shortcut.
Create linked fileCreate linked file allows you to create a new linked file in shortcut.
Create milestone(deprecated: use 'create objective') create milestone allows you to create a new milestone in shortcut.
Create multiple storiesCreate multiple stories allows you to create multiple stories in a single request using the same syntax as [create story](https://developer.
Create objectiveCreate objective allows you to create a new objective in shortcut.
Create projectCreate project is used to create a new shortcut project.
Create storyCreate story is used to add a new story to your shortcut workspace.
Create story commentCreate comment allows you to create a comment on any story.
Create story from templateCreate story from template is used to add a new story derived from a template to your shortcut workspace.
Create story linkStory links (called story relationships in the ui) allow you create semantic relationships between two stories.
Create story reactionCreate a reaction to a story comment.
Create taskCreate task is used to create a new task in a story.
Delete categoryDelete category can be used to delete any category.
Delete custom fieldDeletes a specific custom field from the shortcut system using its unique public identifier.
Delete entity templateDeletes a specific entity template from the shortcut api.
Delete epicDelete epic can be used to delete the epic.
Delete epic commentThis endpoint allows you to delete a comment from an epic.
Delete fileDelete file deletes a previously uploaded file.
Delete iterationDeletes a specific iteration from the shortcut project management system.
Delete labelDelete label can be used to delete any label.
Delete linked fileDelete linked file can be used to delete any previously attached linked-file.
Delete milestone(deprecated: use 'delete objective') delete milestone can be used to delete any milestone.
Delete multiple storiesDelete multiple stories allows you to delete multiple archived stories at once.
Delete objectiveDelete objective can be used to delete any objective.
Delete projectDelete project can be used to delete a project.
Delete storyDelete story can be used to delete any story.
Delete story commentDelete a comment from any story.
Delete story linkRemoves the relationship between the stories for the given story link.
Delete story reactionDelete a reaction from any story comment.
Delete taskDelete task can be used to delete any previously created task on a story.
Disable iterationsDisables iterations for the current workspace
Disable story templatesDisables the story template feature for the workspace.
Enable iterationsEnables iterations for the current workspace
Enable story templatesEnables the story template feature for the workspace.
Get categoryGet category returns information about the selected category.
Get current member infoReturns information about the authenticated member.
Get custom fieldRetrieves detailed information about a specific custom field in shortcut using its unique public identifier.
Get entity templateGet entity template returns information about a given entity template.
Get epicGet epic returns information about the selected epic.
Get epic commentThis endpoint returns information about the selected epic comment.
Get epic workflowReturns the epic workflow for the workspace.
Get external link storiesGet stories which have a given external link associated with them.
Get fileGet file returns information about the selected uploadedfile.
Get groupRetrieves detailed information about a specific group in the shortcut workspace using its unique public identifier.
Get iterationRetrieves detailed information about a specific iteration in the shortcut project management system.
Get key resultGet key result returns information about a chosen key result.
Get labelGet label returns information about the selected label.
Get linked fileGet file returns information about the selected linked file.
Get memberReturns information about a member.
Get milestone(deprecated: use 'get objective') get milestone returns information about a chosen milestone.
Get objectiveGet objective returns information about a chosen objective.
Get projectGet project returns information about the selected project.
Get repositoryGet repository returns information about the selected repository.
Get storyGet story returns information about a chosen story.
Get story commentGet comment is used to get comment information.
Get story linkReturns the stories and their relationship for the given story link.
Get taskReturns information about a chosen task.
Get workflowGet workflow returns information about a chosen workflow.
List categoriesList categories returns a list of all categories and their attributes.
List category milestonesList category milestones returns a list of all milestones with the category.
List category objectivesReturns a list of all objectives with the category.
List custom fieldsRetrieves a list of all custom fields defined in the shortcut api.
List entity templatesList all the entity templates for the workspace.
List epic commentsGet a list of all comments on an epic.
List epicsList epics returns a list of all epics and their attributes.
List epic storiesGet a list of all stories in an epic.
List filesList files returns a list of all uploadedfiles in the workspace.
List groupsA group in our api maps to a "team" within the shortcut product.
List group storiesList the stories assigned to the group.
List iterationsRetrieves a list of all iterations in the shortcut project management system.
List iteration storiesGet a list of all stories in an iteration.
List label epicsList all of the epics with the label.
List labelsList labels returns a list of all labels and their attributes.
List label storiesList all of the stories with the label.
List linked filesList linked files returns a list of all linked-files and their attributes.
List membersReturns information about members of the workspace.
List milestone epics(deprecated: use 'list objective epics') list all of the epics within the milestone.
List milestones(deprecated: use 'list objectives') list milestones returns a list of all milestones and their attributes.
List objective epicsList all of the epics within the objective.
List objectivesList objectives returns a list of all objectives and their attributes.
List projectsList projects returns a list of all projects and their attributes.
List repositoriesList repositories returns a list of all repositories and their attributes.
List storiesList stories returns a list of all stories in a selected project and their attributes.
List story commentLists comments associated with a story
List workflowsReturns a list of all workflows in the workspace.
SearchSearch lets you search epics and stories based on desired parameters.
Search epicsSearch epics lets you search epics based on desired parameters.
Search iterationsSearch iterations lets you search iterations based on desired parameters.
Search milestonesSearch milestones lets you search milestones based on desired parameters.
Search objectivesSearch objectives lets you search objectives based on desired parameters.
Search storiesSearch stories lets you search stories based on desired parameters.
Search stories oldSearch stories lets you search stories based on desired parameters.
Story historyRetrieves the complete history of changes for a specific story in the shortcut project management system.
Unlink comment thread from slackUnlinks a comment from its linked slack thread (comment replies and slack replies will no longer be synced)
Unlink productboard from epicThis endpoint allows you to unlink a productboard epic.
Update categoryUpdate category allows you to replace a category name with another name.
Update custom fieldUpdate custom field can be used to update the definition of a custom field.
Update entity templateUpdate an entity template's name or its contents.
Update epicUpdate epic can be used to update numerous fields in the epic.
Update epic commentThis endpoint allows you to update a threaded comment on an epic.
Update fileUpdate file updates the properties of an uploadedfile (but not its content).
Update groupUpdates an existing group in the shortcut workspace.
Update iterationThis endpoint allows you to update an existing iteration in shortcut.
Update key resultUpdate key result allows updating a key result's name or initial, observed, or target values.
Update labelUpdate label allows you to replace a label name with another name.
Update linked fileUpdated linked file allows you to update properties of a previously attached linked-file.
Update milestone(deprecated: use 'update objective') update milestone can be used to update milestone properties.
Update multiple storiesUpdate multiple stories allows you to make changes to numerous stories at once.
Update objectiveUpdate objective can be used to update objective properties.
Update projectUpdate project can be used to change properties of a project.
Update storyUpdate story can be used to update story properties.
Update story commentUpdate comment replaces the text of the existing comment.
Update story linkUpdates the stories and/or the relationship for the given story link.
Update taskUpdate task can be used to update task properties.
Upload filesUpload files uploads one or many files and optionally associates them with a story.

Connect Shortcut MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Shortcut tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a new epic for the Q3 launch')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Shortcut API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Shortcut Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Create a new epic for the upcoming sprint with description and due date.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Shortcut actions with your Agent

Why Use Composio?

AI Native Shortcut Integration

  • Supports both Shortcut MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Shortcut data

Managed Auth

  • Built-in API key handling with secure storage and scoping
  • Central place to manage, scope, and revoke Shortcut access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Shortcut
  • Scoped, least privilege access to Shortcut resources
  • Full audit trail of agent actions to support review and compliance

Use Shortcut with any AI Agent Framework

Choose a Framework you want to connect Shortcut with

Frequently Asked Questions

Do I need my own developer credentials to use Shortcut with Composio?

Yes, Shortcut requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free