things-app-mcp 1.0.0

package/README.md

@@ -0,0 +1,216 @@
+# Things App MCP
+
+An MCP (Model Context Protocol) server for [Things 3](https://culturedcode.com/things/) on macOS. Enables AI assistants like Claude to create, read, update, and manage your tasks directly in Things.
+
+## Features
+
+### Write Operations (Things URL Scheme)
+
+| Tool | Description |
+|------|-------------|
+| `add-todo` | Create a new to-do with title, notes, dates, tags, checklist, project/area assignment |
+| `add-project` | Create a new project with to-dos, notes, dates, tags, area assignment |
+| `update-todo` | Update an existing to-do (requires auth-token) |
+| `update-project` | Update an existing project (requires auth-token) |
+| `show` | Navigate to a list, project, area, tag, or specific to-do |
+| `search` | Open the Things search screen |
+| `add-json` | Create complex structures via the Things JSON command |
+
+### Read Operations (AppleScript/JXA)
+
+| Tool | Description |
+|------|-------------|
+| `get-todos` | Get to-dos from a list (Inbox, Today, etc.), project, area, or by tag |
+| `get-todo-by-id` | Get a specific to-do by its ID |
+| `get-projects` | Get all projects |
+| `get-project-by-id` | Get a specific project by its ID |
+| `get-areas` | Get all areas |
+| `get-tags` | Get all tags |
+| `search-todos` | Search to-dos by title/notes content |
+| `get-recent-todos` | Get recently modified to-dos |
+
+## Requirements
+
+- **macOS** (required for AppleScript/JXA and `open` command)
+- **Things 3** installed
+- **Node.js** >= 18
+- **Things URL Scheme** enabled (Things > Settings > General > Enable Things URLs)
+
+## Installation
+
+```bash
+# Clone and build
+git clone <repository-url>
+cd things-app-mcp
+npm install
+npm run build
+```
+
+Or install globally:
+
+```bash
+npm install -g things-app-mcp
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "things": {
+      "command": "node",
+      "args": ["/path/to/things-app-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to your Cursor MCP settings (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "things": {
+      "command": "node",
+      "args": ["/path/to/things-app-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### Auth Token (for update operations)
+
+To use `update-todo` and `update-project`, you need your Things auth-token:
+
+1. Open Things on Mac
+2. Go to **Things > Settings > General > Enable Things URLs > Manage**
+3. Copy your authorization token
+4. Pass it as the `authToken` parameter when calling update tools
+
+## Usage Examples
+
+### Adding a To-Do
+
+```
+"Add a to-do called 'Buy groceries' scheduled for today with tags 'Errand'"
+```
+
+The AI will call `add-todo` with:
+```json
+{
+  "title": "Buy groceries",
+  "when": "today",
+  "tags": "Errand"
+}
+```
+
+### Creating a Project with To-Dos
+
+```
+"Create a project called 'Launch Website' in the Work area with to-dos: Design mockups, Build frontend, Deploy"
+```
+
+The AI will call `add-project` with:
+```json
+{
+  "title": "Launch Website",
+  "area": "Work",
+  "todos": "Design mockups\nBuild frontend\nDeploy"
+}
+```
+
+### Complex Project via JSON
+
+```
+"Create a vacation planning project with headings for Travel, Accommodation, and Activities"
+```
+
+The AI will call `add-json` with structured JSON data containing nested headings and to-dos.
+
+### Reading To-Dos
+
+```
+"What's on my Today list?"
+```
+
+The AI will call `get-todos` with `{ "list": "Today" }` and return the structured data.
+
+### Updating a To-Do
+
+```
+"Mark the 'Buy groceries' todo as complete"
+```
+
+The AI will first search/get the to-do to find its ID, then call `update-todo` with the auth-token.
+
+## Things URL Scheme Reference
+
+This MCP server implements the full [Things URL Scheme v2](https://culturedcode.com/things/support/articles/2803573/):
+
+### Date Formats
+
+| Format | Example | Description |
+|--------|---------|-------------|
+| Named | `today`, `tomorrow`, `evening`, `anytime`, `someday` | Built-in schedule options |
+| Date | `2026-03-15` | Specific date |
+| Date + Time | `2026-03-15@14:00` | Date with reminder |
+| Natural language | `next friday`, `in 3 days` | English natural language (parsed by Things) |
+
+### Built-in List IDs (for `show` tool)
+
+`inbox`, `today`, `anytime`, `upcoming`, `someday`, `logbook`, `tomorrow`, `deadlines`, `repeating`, `all-projects`, `logged-projects`
+
+### JSON Command Object Types
+
+| Type | Description |
+|------|-------------|
+| `to-do` | A task with title, notes, when, deadline, tags, checklist-items |
+| `project` | A project with title, notes, items (to-dos and headings) |
+| `heading` | A section heading within a project |
+| `checklist-item` | A checklist item within a to-do |
+
+## Architecture
+
+```
+things-app-mcp/
+  src/
+    index.ts          # MCP server entry point with all tool registrations
+    things-url.ts     # Things URL scheme builder (URL construction)
+    applescript.ts    # AppleScript/JXA executor (read operations)
+  dist/               # Compiled JavaScript output
+  package.json
+  tsconfig.json
+```
+
+### How It Works
+
+- **Write operations** construct `things:///` URLs and open them via macOS `open` command. Things processes the URL and creates/updates items accordingly.
+- **Read operations** use JXA (JavaScript for Automation) scripts executed via `osascript` to query the Things database directly and return structured JSON data.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run directly
+npm start
+```
+
+## License
+
+MIT

package/dist/applescript.d.ts

@@ -0,0 +1,89 @@
+/**
+ * AppleScript executor for reading data from Things 3.
+ * Uses `osascript` to run JXA (JavaScript for Automation) or AppleScript.
+ */
+/**
+ * Opens a Things URL scheme link via `open` command on macOS.
+ */
+export declare function openThingsURL(url: string): Promise<string>;
+export interface ThingsTodo {
+    id: string;
+    name: string;
+    status: "open" | "completed" | "canceled";
+    notes: string;
+    tags: string;
+    dueDate: string | null;
+    activationDate: string | null;
+    creationDate: string;
+    modificationDate: string;
+    completionDate: string | null;
+    projectName: string | null;
+    areaName: string | null;
+}
+export interface ThingsProject {
+    id: string;
+    name: string;
+    status: "open" | "completed" | "canceled";
+    notes: string;
+    tags: string;
+    dueDate: string | null;
+    activationDate: string | null;
+    creationDate: string;
+    modificationDate: string;
+    completionDate: string | null;
+    areaName: string | null;
+    todoCount: number;
+}
+export interface ThingsArea {
+    id: string;
+    name: string;
+    tags: string;
+}
+export interface ThingsTag {
+    name: string;
+}
+/**
+ * Get to-dos from a specific list (inbox, today, anytime, upcoming, someday, logbook).
+ */
+export declare function getTodosFromList(listName: string): Promise<ThingsTodo[]>;
+/**
+ * Get to-dos from a specific project by name.
+ */
+export declare function getTodosFromProject(projectName: string): Promise<ThingsTodo[]>;
+/**
+ * Get to-dos from a specific area by name.
+ */
+export declare function getTodosFromArea(areaName: string): Promise<ThingsTodo[]>;
+/**
+ * Get a specific to-do by ID.
+ */
+export declare function getTodoById(id: string): Promise<ThingsTodo>;
+/**
+ * Get all projects.
+ */
+export declare function getProjects(): Promise<ThingsProject[]>;
+/**
+ * Get a specific project by ID.
+ */
+export declare function getProjectById(id: string): Promise<ThingsProject>;
+/**
+ * Get all areas.
+ */
+export declare function getAreas(): Promise<ThingsArea[]>;
+/**
+ * Get all tags.
+ */
+export declare function getTags(): Promise<ThingsTag[]>;
+/**
+ * Get to-dos tagged with a specific tag name.
+ */
+export declare function getTodosByTag(tagName: string): Promise<ThingsTodo[]>;
+/**
+ * Get recently modified to-dos (within the last N days).
+ */
+export declare function getRecentTodos(days?: number): Promise<ThingsTodo[]>;
+/**
+ * Search for to-dos by title substring.
+ */
+export declare function searchTodosByTitle(query: string): Promise<ThingsTodo[]>;
+//# sourceMappingURL=applescript.d.ts.map

package/dist/applescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.d.ts","sourceRoot":"","sources":["../src/applescript.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6CH;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUhE;AAMD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAuCvB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAsBvB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAsBvB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBjE;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAqB5D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAsBvE;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAYtD;AAED;;GAEG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAUpD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAyB1E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0B5E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,EAAE,CAAC,CA2BvB"}

package/dist/applescript.js

@@ -0,0 +1,343 @@
+/**
+ * AppleScript executor for reading data from Things 3.
+ * Uses `osascript` to run JXA (JavaScript for Automation) or AppleScript.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/**
+ * Executes an AppleScript and returns the output.
+ */
+async function runAppleScript(script) {
+    try {
+        const { stdout } = await execFileAsync("osascript", ["-e", script], {
+            timeout: 15000,
+            maxBuffer: 1024 * 1024 * 5, // 5MB
+        });
+        return stdout.trim();
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`AppleScript execution failed: ${err.stderr || err.message}`);
+    }
+}
+/**
+ * Executes JXA (JavaScript for Automation) and returns parsed JSON.
+ */
+async function runJXA(script) {
+    try {
+        const { stdout } = await execFileAsync("osascript", ["-l", "JavaScript", "-e", script], {
+            timeout: 15000,
+            maxBuffer: 1024 * 1024 * 5,
+        });
+        return JSON.parse(stdout.trim());
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`JXA execution failed: ${err.stderr || err.message}`);
+    }
+}
+/**
+ * Opens a Things URL scheme link via `open` command on macOS.
+ */
+export async function openThingsURL(url) {
+    try {
+        await execFileAsync("open", [url], { timeout: 10000 });
+        return `Successfully opened Things URL: ${url}`;
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Failed to open Things URL: ${err.stderr || err.message}`);
+    }
+}
+// --------------------------------------------------------------------------
+// Query Functions
+// --------------------------------------------------------------------------
+/**
+ * Get to-dos from a specific list (inbox, today, anytime, upcoming, someday, logbook).
+ */
+export async function getTodosFromList(listName) {
+    const validLists = [
+        "Inbox",
+        "Today",
+        "Anytime",
+        "Upcoming",
+        "Someday",
+        "Logbook",
+        "Trash",
+    ];
+    const normalizedList = listName.charAt(0).toUpperCase() + listName.slice(1).toLowerCase();
+    if (!validLists.includes(normalizedList)) {
+        throw new Error(`Invalid list name: ${listName}. Valid lists are: ${validLists.join(", ")}`);
+    }
+    const script = `
+    const things = Application("Things3");
+    const todos = things.lists.byName("${normalizedList}").toDos();
+    const result = todos.map(todo => ({
+      id: todo.id(),
+      name: todo.name(),
+      status: todo.status(),
+      notes: todo.notes() || "",
+      tags: todo.tagNames() || "",
+      dueDate: todo.dueDate() ? todo.dueDate().toISOString() : null,
+      activationDate: todo.activationDate() ? todo.activationDate().toISOString() : null,
+      creationDate: todo.creationDate().toISOString(),
+      modificationDate: todo.modificationDate().toISOString(),
+      completionDate: todo.completionDate() ? todo.completionDate().toISOString() : null,
+      projectName: (() => { try { return todo.project().name(); } catch(e) { return null; } })(),
+      areaName: (() => { try { return todo.area().name(); } catch(e) { return null; } })()
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get to-dos from a specific project by name.
+ */
+export async function getTodosFromProject(projectName) {
+    const escapedName = projectName.replace(/"/g, '\\"');
+    const script = `
+    const things = Application("Things3");
+    const todos = things.projects.byName("${escapedName}").toDos();
+    const result = todos.map(todo => ({
+      id: todo.id(),
+      name: todo.name(),
+      status: todo.status(),
+      notes: todo.notes() || "",
+      tags: todo.tagNames() || "",
+      dueDate: todo.dueDate() ? todo.dueDate().toISOString() : null,
+      activationDate: todo.activationDate() ? todo.activationDate().toISOString() : null,
+      creationDate: todo.creationDate().toISOString(),
+      modificationDate: todo.modificationDate().toISOString(),
+      completionDate: todo.completionDate() ? todo.completionDate().toISOString() : null,
+      projectName: "${escapedName}",
+      areaName: (() => { try { return todo.area().name(); } catch(e) { return null; } })()
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get to-dos from a specific area by name.
+ */
+export async function getTodosFromArea(areaName) {
+    const escapedName = areaName.replace(/"/g, '\\"');
+    const script = `
+    const things = Application("Things3");
+    const todos = things.areas.byName("${escapedName}").toDos();
+    const result = todos.map(todo => ({
+      id: todo.id(),
+      name: todo.name(),
+      status: todo.status(),
+      notes: todo.notes() || "",
+      tags: todo.tagNames() || "",
+      dueDate: todo.dueDate() ? todo.dueDate().toISOString() : null,
+      activationDate: todo.activationDate() ? todo.activationDate().toISOString() : null,
+      creationDate: todo.creationDate().toISOString(),
+      modificationDate: todo.modificationDate().toISOString(),
+      completionDate: todo.completionDate() ? todo.completionDate().toISOString() : null,
+      projectName: (() => { try { return todo.project().name(); } catch(e) { return null; } })(),
+      areaName: "${escapedName}"
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get a specific to-do by ID.
+ */
+export async function getTodoById(id) {
+    const escapedId = id.replace(/"/g, '\\"');
+    const script = `
+    const things = Application("Things3");
+    const todo = things.toDos.byId("${escapedId}");
+    const result = {
+      id: todo.id(),
+      name: todo.name(),
+      status: todo.status(),
+      notes: todo.notes() || "",
+      tags: todo.tagNames() || "",
+      dueDate: todo.dueDate() ? todo.dueDate().toISOString() : null,
+      activationDate: todo.activationDate() ? todo.activationDate().toISOString() : null,
+      creationDate: todo.creationDate().toISOString(),
+      modificationDate: todo.modificationDate().toISOString(),
+      completionDate: todo.completionDate() ? todo.completionDate().toISOString() : null,
+      projectName: (() => { try { return todo.project().name(); } catch(e) { return null; } })(),
+      areaName: (() => { try { return todo.area().name(); } catch(e) { return null; } })()
+    };
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get all projects.
+ */
+export async function getProjects() {
+    const script = `
+    const things = Application("Things3");
+    const projects = things.projects();
+    const result = projects.map(proj => ({
+      id: proj.id(),
+      name: proj.name(),
+      status: proj.status(),
+      notes: proj.notes() || "",
+      tags: proj.tagNames() || "",
+      dueDate: proj.dueDate() ? proj.dueDate().toISOString() : null,
+      activationDate: proj.activationDate() ? proj.activationDate().toISOString() : null,
+      creationDate: proj.creationDate().toISOString(),
+      modificationDate: proj.modificationDate().toISOString(),
+      completionDate: proj.completionDate() ? proj.completionDate().toISOString() : null,
+      areaName: (() => { try { return proj.area().name(); } catch(e) { return null; } })(),
+      todoCount: proj.toDos().length
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get a specific project by ID.
+ */
+export async function getProjectById(id) {
+    const escapedId = id.replace(/"/g, '\\"');
+    const script = `
+    const things = Application("Things3");
+    const proj = things.projects.byId("${escapedId}");
+    const result = {
+      id: proj.id(),
+      name: proj.name(),
+      status: proj.status(),
+      notes: proj.notes() || "",
+      tags: proj.tagNames() || "",
+      dueDate: proj.dueDate() ? proj.dueDate().toISOString() : null,
+      activationDate: proj.activationDate() ? proj.activationDate().toISOString() : null,
+      creationDate: proj.creationDate().toISOString(),
+      modificationDate: proj.modificationDate().toISOString(),
+      completionDate: proj.completionDate() ? proj.completionDate().toISOString() : null,
+      areaName: (() => { try { return proj.area().name(); } catch(e) { return null; } })(),
+      todoCount: proj.toDos().length
+    };
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get all areas.
+ */
+export async function getAreas() {
+    const script = `
+    const things = Application("Things3");
+    const areas = things.areas();
+    const result = areas.map(area => ({
+      id: area.id(),
+      name: area.name(),
+      tags: area.tagNames() || ""
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get all tags.
+ */
+export async function getTags() {
+    const script = `
+    const things = Application("Things3");
+    const tags = things.tags();
+    const result = tags.map(tag => ({
+      name: tag.name()
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get to-dos tagged with a specific tag name.
+ */
+export async function getTodosByTag(tagName) {
+    const escapedName = tagName.replace(/"/g, '\\"');
+    const script = `
+    const things = Application("Things3");
+    const allTodos = things.toDos();
+    const result = allTodos.filter(todo => {
+      const tags = todo.tagNames() || "";
+      return tags.split(", ").some(t => t === "${escapedName}");
+    }).map(todo => ({
+      id: todo.id(),
+      name: todo.name(),
+      status: todo.status(),
+      notes: todo.notes() || "",
+      tags: todo.tagNames() || "",
+      dueDate: todo.dueDate() ? todo.dueDate().toISOString() : null,
+      activationDate: todo.activationDate() ? todo.activationDate().toISOString() : null,
+      creationDate: todo.creationDate().toISOString(),
+      modificationDate: todo.modificationDate().toISOString(),
+      completionDate: todo.completionDate() ? todo.completionDate().toISOString() : null,
+      projectName: (() => { try { return todo.project().name(); } catch(e) { return null; } })(),
+      areaName: (() => { try { return todo.area().name(); } catch(e) { return null; } })()
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Get recently modified to-dos (within the last N days).
+ */
+export async function getRecentTodos(days = 7) {
+    const script = `
+    const things = Application("Things3");
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - ${days});
+    const allTodos = things.toDos();
+    const result = allTodos.filter(todo => {
+      const modDate = todo.modificationDate();
+      return modDate && modDate >= cutoff;
+    }).map(todo => ({
+      id: todo.id(),
+      name: todo.name(),
+      status: todo.status(),
+      notes: todo.notes() || "",
+      tags: todo.tagNames() || "",
+      dueDate: todo.dueDate() ? todo.dueDate().toISOString() : null,
+      activationDate: todo.activationDate() ? todo.activationDate().toISOString() : null,
+      creationDate: todo.creationDate().toISOString(),
+      modificationDate: todo.modificationDate().toISOString(),
+      completionDate: todo.completionDate() ? todo.completionDate().toISOString() : null,
+      projectName: (() => { try { return todo.project().name(); } catch(e) { return null; } })(),
+      areaName: (() => { try { return todo.area().name(); } catch(e) { return null; } })()
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+/**
+ * Search for to-dos by title substring.
+ */
+export async function searchTodosByTitle(query) {
+    const escapedQuery = query.replace(/"/g, '\\"').replace(/\\/g, "\\\\");
+    const script = `
+    const things = Application("Things3");
+    const allTodos = things.toDos();
+    const queryLower = "${escapedQuery}".toLowerCase();
+    const result = allTodos.filter(todo => {
+      const name = todo.name() || "";
+      const notes = todo.notes() || "";
+      return name.toLowerCase().includes(queryLower) || notes.toLowerCase().includes(queryLower);
+    }).map(todo => ({
+      id: todo.id(),
+      name: todo.name(),
+      status: todo.status(),
+      notes: todo.notes() || "",
+      tags: todo.tagNames() || "",
+      dueDate: todo.dueDate() ? todo.dueDate().toISOString() : null,
+      activationDate: todo.activationDate() ? todo.activationDate().toISOString() : null,
+      creationDate: todo.creationDate().toISOString(),
+      modificationDate: todo.modificationDate().toISOString(),
+      completionDate: todo.completionDate() ? todo.completionDate().toISOString() : null,
+      projectName: (() => { try { return todo.project().name(); } catch(e) { return null; } })(),
+      areaName: (() => { try { return todo.area().name(); } catch(e) { return null; } })()
+    }));
+    JSON.stringify(result);
+  `;
+    return runJXA(script);
+}
+//# sourceMappingURL=applescript.js.map

package/dist/applescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../src/applescript.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * Things MCP Server
+ *
+ * An MCP server that provides tools and resources for interacting with
+ * Things 3 (macOS) via the Things URL Scheme and AppleScript/JXA.
+ *
+ * Tools (write operations via URL scheme):
+ *   - add-todo: Create a new to-do
+ *   - add-project: Create a new project
+ *   - update-todo: Update an existing to-do (requires auth-token)
+ *   - update-project: Update an existing project (requires auth-token)
+ *   - show: Navigate to a list, project, area, tag, or to-do
+ *   - search: Open the search screen in Things
+ *   - add-json: Create complex projects/to-dos via JSON
+ *
+ * Tools (read operations via AppleScript/JXA):
+ *   - get-todos: Get to-dos from a list, project, area, or by tag
+ *   - get-projects: Get all projects
+ *   - get-areas: Get all areas
+ *   - get-tags: Get all tags
+ *   - get-todo-by-id: Get a specific to-do by ID
+ *   - get-project-by-id: Get a specific project by ID
+ *   - search-todos: Search to-dos by title/notes content
+ *   - get-recent-todos: Get recently modified to-dos
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}