SupaThings MCP

Implementation Reference

• src/index.ts:1646-1672 (handler)

  The "show-quick-entry" tool is defined in src/index.ts. It checks if the Things application is available and then executes an AppleScript to show the quick entry panel, optionally with autofill.

  server.tool(
    "show-quick-entry",
    {
      withAutofill: z.boolean().optional().describe("Open quick entry with autofill"),
    },
    async ({ withAutofill }) => {
      const appleScriptStatus = await getAppleScriptOperationalStatus();
      if (!appleScriptStatus.operational) {
        return buildTextResponse("Things quick entry unavailable", {
          success: false,
          available: appleScriptStatus.available,
          operational: appleScriptStatus.operational,
          error:
            appleScriptStatus.operationalError ?? appleScriptStatus.availabilityError,
        });
      }
  
      const script = withAutofill
        ? `tell application "${THINGS_APP_SCRIPT_TARGET}" to show quick entry panel with autofill`
        : `tell application "${THINGS_APP_SCRIPT_TARGET}" to show quick entry panel`;
      const result = await tryAppleScript(script);
      return buildTextResponse(
        result.ok ? "Opened Things quick entry" : "Things quick entry unavailable",
        result.ok ? { success: true } : { success: false, error: result.error }
      );
    }
  );