Shortcut MCP Server

Instructions

Implementation Reference

• src/tools/workflows.ts:47-79 (handler)

  The main handler function that retrieves the default workflow for a team or the global default, using the ShortcutClientWrapper.

  async getDefaultWorkflow(teamPublicId?: string) {
  	if (teamPublicId) {
  		try {
  			const teamDefaultWorkflowId = await this.client
  				.getTeam(teamPublicId)
  				.then((t) => t?.default_workflow_id);
  			if (teamDefaultWorkflowId) {
  				const teamDefaultWorkflow = await this.client.getWorkflow(teamDefaultWorkflowId);
  				if (teamDefaultWorkflow) {
  					return this.toResult(
  						`Default workflow for team "${teamPublicId}" has id ${teamDefaultWorkflow.id}.`,
  						await this.entityWithRelatedEntities(teamDefaultWorkflow, "workflow"),
  					);
  				}
  			}
  		} catch {}
  	}
  
  	const currentUser = await this.client.getCurrentUser();
  	if (!currentUser) throw new Error("Failed to retrieve current user.");
  
  	const workspaceDefaultWorkflowId = currentUser.workspace2.default_workflow_id;
  	const workspaceDefaultWorkflow = await this.client.getWorkflow(workspaceDefaultWorkflowId);
  
  	if (workspaceDefaultWorkflow) {
  		return this.toResult(
  			`${teamPublicId ? `No default workflow found for team with public ID "${teamPublicId}". The general default workflow has id ` : "Default workflow has id "}${workspaceDefaultWorkflow.id}.`,
  			await this.entityWithRelatedEntities(workspaceDefaultWorkflow, "workflow"),
  		);
  	}
  
  	return this.toResult("No default workflow found.");
  }

• src/tools/workflows.ts:10-20 (registration)

  Registers the 'workflows-get-default' tool with the MCP server, including schema and handler reference.

  server.addToolWithReadAccess(
  	"workflows-get-default",
  	"Get the default workflow for a specific team or the global default if no team is specified.",
  	{
  		teamPublicId: z
  			.string()
  			.optional()
  			.describe("The public ID of the team to get the default workflow for."),
  	},
  	async ({ teamPublicId }) => await tools.getDefaultWorkflow(teamPublicId),
  );

• src/tools/workflows.ts:13-18 (schema)

  Zod schema for the tool input parameters.

  {
  	teamPublicId: z
  		.string()
  		.optional()
  		.describe("The public ID of the team to get the default workflow for."),
  },