Siri Shortcuts MCP Server

Instructions

Implementation Reference

• shortcuts.ts:144-169 (handler)

  The handler function for the 'open_shortcut' tool. It executes the shell command 'shortcuts view <name>' to open the specified shortcut in the Shortcuts app, returning success or error.

  const openShortcut = async (params: OpenShortcutInput): Promise<ToolResult> => {
    return new Promise((resolve, reject) => {
      const command = `shortcuts view '${params.name}'`;
      exec(command, (error, stdout, stderr) => {
        if (error) {
          reject(
            new McpError(
              ErrorCode.InternalError,
              `Failed to open shortcut: ${error.message}`,
            ),
          );
          return;
        }
        if (stderr) {
          reject(
            new McpError(
              ErrorCode.InternalError,
              `Error opening shortcut: ${stderr}`,
            ),
          );
          return;
        }
        resolve({ success: true, message: `Opened shortcut: ${params.name}` });
      });
    });
  };

• shortcuts.ts:28-32 (schema)

  Zod schema defining the input for the open_shortcut tool: an object with a required 'name' string.

  const OpenShortcutSchema = z
    .object({
      name: z.string().describe("The name of the shortcut to open"),
    })
    .strict();

• shortcuts.ts:300-304 (registration)

  Registration of the 'open_shortcut' tool in the base tools array, specifying name, description, input schema, and run handler that delegates to openShortcut.

    name: ToolName.OPEN_SHORTCUT,
    description: "Open a shortcut in the Shortcuts app",
    inputSchema: zodToJsonSchema(OpenShortcutSchema) as ToolInput,
    run: (params: any) => openShortcut(params as OpenShortcutInput),
  },

• shortcuts.ts:391-392 (registration)

  Dispatch logic in the CallToolRequest handler that invokes openShortcut when the tool name is OPEN_SHORTCUT.

  case ToolName.OPEN_SHORTCUT:
    result = await openShortcut(args as OpenShortcutInput);

• shortcuts.ts:48-48 (helper)

  ToolName enum value defining the string name 'open_shortcut'.

  OPEN_SHORTCUT = "open_shortcut",