search-objectives

Locate Shortcut objectives by filtering through ID, name, state, owner, team, creation date, or completion status. Access and manage project tasks directly via the MCP server integration.

Instructions

Find Shortcut objectives.

Input Schema

Name	Required	Description
`completed`	No
`created`	No	The date in "YYYY-MM-DD" format, or one of the keywords: "yesterday", "today", "tomorrow", or a date range in the format "YYYY-MM-DD..YYYY-MM-DD". The date range can also be open ended by using "" for one of the bounds. Examples: "2023-01-01", "today", "2023-01-01.." (from Jan 1, 2023 to any future date), ".2023-01-31" (any date up to Jan 31, 2023), "today.." (from today onwards), "*.yesterday" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: "today-1" or "tomorrow+1").
`description`	No	Find objectives matching the specified description
`hasOwner`	No	Find only entities that have an owner when true, or only entities that do not have an owner when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.
`id`	No	Find objectives matching the specified id
`isArchived`	No	Find only entities that are archived when true, or only entities that are not archived when false.
`isDone`	No	Find only entities that are completed when true, or only entities that are not completed when false.
`isStarted`	No	Find only entities that are started when true, or only entities that are not started when false.
`isUnstarted`	No	Find only entities that are unstarted when true, or only entities that are not unstarted when false.
`name`	No	Find objectives matching the specified name
`owner`	No	Find entities where the owner match the specified user. This must either be the user's mention name or the keyword "me" for the current user.
`requester`	No	Find entities where the requester match the specified user. This must either be the user's mention name or the keyword "me" for the current user.
`state`	No	Find objectives matching the specified state
`team`	No	Find objectives matching the specified team. Should be a team mention name.
`updated`	No

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "completed": {
      "$ref": "#/properties/created"
    },
    "created": {
      "description": "The date in \"YYYY-MM-DD\" format, or one of the keywords: \"yesterday\", \"today\", \"tomorrow\", or a date range in the format \"YYYY-MM-DD..YYYY-MM-DD\". The date range can also be open ended by using \"*\" for one of the bounds. Examples: \"2023-01-01\", \"today\", \"2023-01-01..*\" (from Jan 1, 2023 to any future date), \"*.2023-01-31\" (any date up to Jan 31, 2023), \"today..*\" (from today onwards), \"*.yesterday\" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: \"today-1\" or \"tomorrow+1\").",
      "pattern": "^(today|tomorrow|yesterday|\\d{4}-\\d{2}-\\d{2}|today\\.\\.\\*|\\*\\.\\.today|yesterday\\.\\.\\*|\\*\\.\\.yesterday|tomorrow\\.\\.\\*|\\*\\.\\.tomorrow|\\d{4}-\\d{2}-\\d{2}\\.\\.\\*|\\*\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2})$",
      "type": "string"
    },
    "description": {
      "description": "Find objectives matching the specified description",
      "type": "string"
    },
    "hasOwner": {
      "description": "Find only entities that have an owner when true, or only entities that do not have an owner when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner.",
      "type": "boolean"
    },
    "id": {
      "description": "Find objectives matching the specified id",
      "type": "number"
    },
    "isArchived": {
      "description": "Find only entities that are archived when true, or only entities that are not archived when false.",
      "type": "boolean"
    },
    "isDone": {
      "description": "Find only entities that are completed when true, or only entities that are not completed when false.",
      "type": "boolean"
    },
    "isStarted": {
      "description": "Find only entities that are started when true, or only entities that are not started when false.",
      "type": "boolean"
    },
    "isUnstarted": {
      "description": "Find only entities that are unstarted when true, or only entities that are not unstarted when false.",
      "type": "boolean"
    },
    "name": {
      "description": "Find objectives matching the specified name",
      "type": "string"
    },
    "owner": {
      "description": "Find entities where the owner match the specified user. This must either be the user's mention name or the keyword \"me\" for the current user.",
      "type": "string"
    },
    "requester": {
      "description": "Find entities where the requester match the specified user. This must either be the user's mention name or the keyword \"me\" for the current user.",
      "type": "string"
    },
    "state": {
      "description": "Find objectives matching the specified state",
      "enum": [
        "unstarted",
        "started",
        "done"
      ],
      "type": "string"
    },
    "team": {
      "description": "Find objectives matching the specified team. Should be a team mention name.",
      "type": "string"
    },
    "updated": {
      "$ref": "#/properties/created"
    }
  },
  "type": "object"
}

Shortcut MCP Server

search-objectives

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Shortcut MCP Server

Related Tools

MCP directory API