SupaThings MCP

Implementation Reference

• src/index.ts:1845-1866 (handler)

  The `app-status` tool is registered and implemented directly in `src/index.ts`. It checks if the Things application is installed, whether it is running, its AppleScript availability/status, and locates the database file.

        todosByHeading: todos_by_heading ?? {},
        todos: todos ?? [],
        payload,
        url,
        guidance:
          "Use this tool for brand-new projects that need headings. For existing projects, inspect headings first and ask the user to create missing headings manually.",
      });
    }
  );
  
  server.tool(
    "add-project",
    {
      title: z.string().describe("Simple project title. This command creates a project only and does not create headings."),
      notes: z.string().optional(),
      when: z.string().optional(),
      deadline: z.string().optional(),
      tags: z.array(z.string()).optional(),
      "area-id": z.string().optional(),
      area: z.string().optional(),
      "to-dos": z.array(z.string()).optional().describe("Optional simple to-dos to add to the project. If headings are needed, prefer create-project-with-headings or json."),
      completed: z.boolean().optional(),