Shortcut MCP Server

Instructions

Implementation Reference

• src/tools/epics.ts:104-123 (handler)

  The main handler function that executes the logic to create a new Shortcut epic using the client.createEpic method and returns a result.

  async createEpic({
  	name,
  	owner,
  	teamId: group_id,
  	description,
  }: {
  	name: string;
  	owner?: string;
  	teamId?: string;
  	description?: string;
  }): Promise<CallToolResult> {
  	const epic = await this.client.createEpic({
  		name,
  		group_id,
  		owner_ids: owner ? [owner] : undefined,
  		description,
  	});
  
  	return this.toResult(`Epic created with ID: ${epic.id}.`);
  }

• src/tools/epics.ts:64-74 (registration)

  Tool registration for 'create-epic', including the tool name, description, input schema, and reference to the handler function.

  server.tool(
  	"create-epic",
  	"Create a new Shortcut epic.",
  	{
  		name: z.string().describe("The name of the epic"),
  		owner: z.string().optional().describe("The user ID of the owner of the epic"),
  		description: z.string().optional().describe("A description of the epic"),
  		teamId: z.string().optional().describe("The ID of a team to assign the epic to"),
  	},
  	async (params) => await tools.createEpic(params),
  );

• src/tools/epics.ts:67-72 (schema)

  Zod schema defining the input parameters for the create-epic tool: name (required), owner, description, teamId (all optional except name).

  {
  	name: z.string().describe("The name of the epic"),
  	owner: z.string().optional().describe("The user ID of the owner of the epic"),
  	description: z.string().optional().describe("A description of the epic"),
  	teamId: z.string().optional().describe("The ID of a team to assign the epic to"),
  },