things-mcp-server 0.1.2 → 0.1.4

package/README.md

@@ -11,13 +11,18 @@ A local MCP server for controlling [Things](https://culturedcode.com/things/) on
   - `things_list_areas`
   - `things_list_area_items`
   - `things_list_project_todos`
+  - `things_list_tags`
+  - `things_list_tag_todos`
   - `things_search_todos`
   - `things_get_todo`
 - Write:
   - `things_add_area`
+  - `things_add_tag`
   - `things_add_todo`
   - `things_add_project`
+  - `things_update_tag`
   - `things_update_todo`
+  - `things_delete_tag`
   - `things_complete_todo`
   - `things_move_todo`
   - `things_delete_todo`
@@ -53,6 +58,8 @@ pnpm build
 pnpm test
 ```
 
+`tests/sqlite-read-adapter.test.ts` only runs when `better-sqlite3` native binding can be loaded by the current Node runtime; otherwise that suite is skipped.
+
 ## Run
 
 ```bash
@@ -119,11 +126,12 @@ If `lastOpenError` includes `NODE_MODULE_VERSION` mismatch:
 
 ## Tool Safety Notes
 
-- `things_add_area`, `things_add_todo`, `things_add_project`, `things_update_todo`, `things_complete_todo`, `things_move_todo`, and `things_delete_todo` all require `confirm=true`.
+- `things_add_area`, `things_add_tag`, `things_add_todo`, `things_add_project`, `things_update_tag`, `things_update_todo`, `things_delete_tag`, `things_complete_todo`, `things_move_todo`, and `things_delete_todo` all require `confirm=true`.
 - This server does not execute arbitrary scripts.
 - Reads are done via AppleScript.
-- URL-scheme-supported operations use Things URL scheme (`add_todo`, `add_project`, `move_todo`, `complete_todo`, `show_item`), and `update_todo` when heading placement is requested.
-- AppleScript is used for read operations, plus write operations `add_area`, `delete_todo`, and most `update_todo` cases.
+- URL-scheme-supported operations use Things URL scheme (`add_todo`, `add_project`, `move_todo`, `complete_todo`, `show_item`), and `update_todo` when heading placement or tag updates are requested.
+- AppleScript is used for read operations, plus write operations `add_area`, `delete_todo`, and `update_todo` cases that do not include heading/tag updates.
+- For `update_todo` tag updates, tag names must already exist in Things. The server validates this and returns an explicit error if any tag is missing.
 
 ## Read Detail Fields
 
@@ -153,6 +161,7 @@ Container support:
 - `things_add_project` supports creating projects inside area via `area` or `areaId`.
 - `things_add_todo` supports direct placement via `list/listId` and optional `heading/headingId`.
 - `things_move_todo` supports moving into standard list, project, area, or heading.
+- `things_list_tag_todos` supports querying todos by `tag` (name) or `tagId`.
 
 ## Known Limitations
 

package/dist/adapters/apple-script-adapter.js

@@ -705,6 +705,44 @@ function parseAreasPayload(payload, limit, offset) {
         items
     };
 }
+function parseTagsPayload(payload, limit, offset) {
+    const normalized = payload.trim();
+    if (!normalized.startsWith("TOTAL:")) {
+        throw new ThingsOperationError("Malformed response from Things AppleScript adapter.");
+    }
+    const [header, ...rows] = normalized.split("\n");
+    const total = Number(header.replace("TOTAL:", "").trim());
+    if (!Number.isFinite(total) || total < 0) {
+        throw new ThingsOperationError("Invalid total value from Things AppleScript adapter.");
+    }
+    const items = rows
+        .filter((line) => line.trim().length > 0)
+        .map((line) => {
+        const [id, title, parentIdRaw, parentNameRaw, todoCountRaw, childCountRaw] = line.split("\t");
+        const parentId = parseOptional(parentIdRaw);
+        const parentName = parseOptional(parentNameRaw);
+        const todoCount = Number(todoCountRaw);
+        const childCount = Number(childCountRaw);
+        return {
+            id,
+            title,
+            parentId,
+            parentName,
+            todoCount: Number.isFinite(todoCount) ? todoCount : 0,
+            childCount: Number.isFinite(childCount) ? childCount : 0
+        };
+    });
+    const count = items.length;
+    const hasMore = offset + count < total;
+    return {
+        total,
+        count,
+        offset,
+        has_more: hasMore,
+        next_offset: hasMore ? offset + count : undefined,
+        items
+    };
+}
 function parseAreaItemsPayload(payload, limit, offset) {
     const normalized = payload.trim();
     if (!normalized.startsWith("TOTAL:")) {
@@ -969,6 +1007,86 @@ export class AppleScriptAdapter {
         const output = await this.runAppleScript(lines, [String(input.limit), String(input.offset)]);
         return parseAreasPayload(output, input.limit, input.offset);
     }
+    async listTags(input) {
+        const lines = [
+            "on replaceText(findText, replaceText, sourceText)",
+            "set AppleScript's text item delimiters to findText",
+            "set tempList to every text item of sourceText",
+            "set AppleScript's text item delimiters to replaceText",
+            "set outputText to tempList as text",
+            "set AppleScript's text item delimiters to \"\"",
+            "return outputText",
+            "end replaceText",
+            "",
+            "on sanitizeText(sourceText)",
+            "set cleanedText to my replaceText(tab, \" \", sourceText)",
+            "set cleanedText to my replaceText(return, \" \", cleanedText)",
+            "set cleanedText to my replaceText(linefeed, \" \", cleanedText)",
+            "return cleanedText",
+            "end sanitizeText",
+            "",
+            "on safeTagId(sourceTag)",
+            "if sourceTag is missing value then return \"\"",
+            "try",
+            "return id of sourceTag as text",
+            "on error",
+            "return \"\"",
+            "end try",
+            "end safeTagId",
+            "",
+            "on safeTagName(sourceTag)",
+            "if sourceTag is missing value then return \"\"",
+            "try",
+            "return my sanitizeText(name of sourceTag as text)",
+            "on error",
+            "return \"\"",
+            "end try",
+            "end safeTagName",
+            "",
+            "on run argv",
+            "set limitNum to item 1 of argv as integer",
+            "set offsetNum to item 2 of argv as integer",
+            "tell application \"Things3\"",
+            "set sourceTags to tags",
+            "set totalCount to count of sourceTags",
+            "set startIndex to offsetNum + 1",
+            "if startIndex > totalCount then",
+            "return \"TOTAL:\" & totalCount",
+            "end if",
+            "set endIndex to offsetNum + limitNum",
+            "if endIndex > totalCount then set endIndex to totalCount",
+            "set linesOut to {}",
+            "repeat with i from startIndex to endIndex",
+            "set currentTag to item i of sourceTags",
+            "set tagId to id of currentTag as text",
+            "set tagName to my sanitizeText(name of currentTag as text)",
+            "set parentTagId to \"\"",
+            "set parentTagName to \"\"",
+            "try",
+            "set parentTagObj to parent tag of currentTag",
+            "set parentTagId to my safeTagId(parentTagObj)",
+            "set parentTagName to my safeTagName(parentTagObj)",
+            "end try",
+            "set todoCount to 0",
+            "try",
+            "set todoCount to count of to dos of currentTag",
+            "end try",
+            "set childCount to 0",
+            "try",
+            "set childCount to count of tags of currentTag",
+            "end try",
+            "set end of linesOut to tagId & tab & tagName & tab & parentTagId & tab & parentTagName & tab & todoCount & tab & childCount",
+            "end repeat",
+            "set AppleScript's text item delimiters to linefeed",
+            "set linesText to linesOut as text",
+            "set AppleScript's text item delimiters to \"\"",
+            "return \"TOTAL:\" & totalCount & linefeed & linesText",
+            "end tell",
+            "end run"
+        ];
+        const output = await this.runAppleScript(lines, [String(input.limit), String(input.offset)]);
+        return parseTagsPayload(output, input.limit, input.offset);
+    }
     async listAreaItems(input) {
         const lines = [
             "on replaceText(findText, replaceText, sourceText)",
@@ -1115,6 +1233,94 @@ export class AppleScriptAdapter {
         ]);
         return parseListPayload(output, input.limit, input.offset);
     }
+    async listTagTodos(input) {
+        const tagName = AppleScriptAdapter.sanitizeAppleScriptText(input.tag ?? "");
+        const lines = [
+            "on replaceText(findText, replaceText, sourceText)",
+            "set AppleScript's text item delimiters to findText",
+            "set tempList to every text item of sourceText",
+            "set AppleScript's text item delimiters to replaceText",
+            "set outputText to tempList as text",
+            "set AppleScript's text item delimiters to \"\"",
+            "return outputText",
+            "end replaceText",
+            "",
+            "on sanitizeText(sourceText)",
+            "set cleanedText to my replaceText(tab, \" \", sourceText)",
+            "set cleanedText to my replaceText(return, \" \", cleanedText)",
+            "set cleanedText to my replaceText(linefeed, \" \", cleanedText)",
+            "return cleanedText",
+            "end sanitizeText",
+            "",
+            "on formatDate(sourceDate)",
+            "if sourceDate is missing value then return \"\"",
+            "try",
+            "return (sourceDate as «class isot») as text",
+            "on error",
+            "return sourceDate as text",
+            "end try",
+            "end formatDate",
+            "",
+            "on resolveTagByIdOrName(targetTagId, targetTagName)",
+            "if targetTagId is not \"\" then",
+            "try",
+            "return first tag whose id is targetTagId",
+            "on error",
+            "error \"Target tag ID not found: \" & targetTagId",
+            "end try",
+            "end if",
+            "if targetTagName is \"\" then error \"No tag specified.\"",
+            "try",
+            "return first tag whose name is targetTagName",
+            "on error",
+            "error \"Target tag not found: \" & targetTagName",
+            "end try",
+            "end resolveTagByIdOrName",
+            "",
+            "on run argv",
+            "set targetTagId to item 1 of argv",
+            "set targetTagName to item 2 of argv",
+            "set limitNum to item 3 of argv as integer",
+            "set offsetNum to item 4 of argv as integer",
+            "tell application \"Things3\"",
+            "set targetTag to my resolveTagByIdOrName(targetTagId, targetTagName)",
+            "set sourceTodos to to dos of targetTag",
+            "set totalCount to count of sourceTodos",
+            "set startIndex to offsetNum + 1",
+            "if startIndex > totalCount then",
+            "return \"TOTAL:\" & totalCount",
+            "end if",
+            "set endIndex to offsetNum + limitNum",
+            "if endIndex > totalCount then set endIndex to totalCount",
+            "set linesOut to {}",
+            "repeat with i from startIndex to endIndex",
+            "set currentTodo to item i of sourceTodos",
+            "set todoId to id of currentTodo as text",
+            "set todoName to my sanitizeText(name of currentTodo as text)",
+            "set todoStatus to status of currentTodo as text",
+            "set todoDueDate to my formatDate(due date of currentTodo)",
+            "set todoActivationDate to my formatDate(activation date of currentTodo)",
+            "set todoJson to \"\"",
+            "try",
+            "set todoJson to my sanitizeText(|_private_experimental_ json| of currentTodo as text)",
+            "end try",
+            "set end of linesOut to todoId & tab & todoName & tab & todoStatus & tab & todoDueDate & tab & todoActivationDate & tab & todoJson",
+            "end repeat",
+            "set AppleScript's text item delimiters to linefeed",
+            "set linesText to linesOut as text",
+            "set AppleScript's text item delimiters to \"\"",
+            "return \"TOTAL:\" & totalCount & linefeed & linesText",
+            "end tell",
+            "end run"
+        ];
+        const output = await this.runAppleScript(lines, [
+            input.tagId ?? "",
+            tagName,
+            String(input.limit),
+            String(input.offset)
+        ]);
+        return parseListPayload(output, input.limit, input.offset);
+    }
     async searchTodos(input) {
         const query = AppleScriptAdapter.sanitizeAppleScriptText(input.query);
         const lines = [
@@ -1180,6 +1386,32 @@ export class AppleScriptAdapter {
         const output = await this.runAppleScript(lines, [query, String(input.limit), String(input.offset)]);
         return parseListPayload(output, input.limit, input.offset);
     }
+    async listTagNames() {
+        const lines = [
+            "on run argv",
+            "tell application \"Things3\"",
+            "set allTags to tags",
+            "set tagNames to {}",
+            "repeat with currentTag in allTags",
+            "set end of tagNames to (name of currentTag as text)",
+            "end repeat",
+            "if (count of tagNames) is 0 then return \"\"",
+            "set AppleScript's text item delimiters to linefeed",
+            "set outputText to tagNames as text",
+            "set AppleScript's text item delimiters to \"\"",
+            "return outputText",
+            "end tell",
+            "end run"
+        ];
+        const output = (await this.runAppleScript(lines, [])).trim();
+        if (output.length === 0) {
+            return [];
+        }
+        return output
+            .split(/\r?\n/)
+            .map((value) => value.trim())
+            .filter((value) => value.length > 0);
+    }
     async getTodo(id) {
         const lines = [
             "on replaceText(findText, replaceText, sourceText)",
@@ -1525,6 +1757,49 @@ export class AppleScriptAdapter {
             input.listId ?? ""
         ]);
     }
+    async addTag(input) {
+        const tagTitle = AppleScriptAdapter.sanitizeAppleScriptText(input.title);
+        const lines = [
+            "on run argv",
+            "set requestedName to item 1 of argv",
+            "tell application \"Things3\"",
+            "set existingTag to missing value",
+            "try",
+            "set existingTag to first tag whose name is requestedName",
+            "end try",
+            "if existingTag is not missing value then return id of existingTag as text",
+            "set newTag to make new tag with properties {name:requestedName}",
+            "return id of newTag as text",
+            "end tell",
+            "end run"
+        ];
+        return (await this.runAppleScript(lines, [tagTitle])).trim();
+    }
+    async updateTag(input) {
+        const tagTitle = AppleScriptAdapter.sanitizeAppleScriptText(input.title);
+        const lines = [
+            "on run argv",
+            "set targetId to item 1 of argv",
+            "set tagTitle to item 2 of argv",
+            "tell application \"Things3\"",
+            "set targetTag to first tag whose id is targetId",
+            "set name of targetTag to tagTitle",
+            "end tell",
+            "end run"
+        ];
+        await this.runAppleScript(lines, [input.id, tagTitle]);
+    }
+    async deleteTag(input) {
+        const lines = [
+            "on run argv",
+            "set targetId to item 1 of argv",
+            "tell application \"Things3\"",
+            "delete (first tag whose id is targetId)",
+            "end tell",
+            "end run"
+        ];
+        await this.runAppleScript(lines, [input.id]);
+    }
     async completeTodo(id) {
         const lines = [
             "on run argv",

package/dist/adapters/url-scheme-adapter.js

@@ -62,7 +62,7 @@ export class UrlSchemeAdapter {
             "list-id": input.listId,
             heading: input.heading,
             "heading-id": input.headingId,
-            tags: input.tags?.join(","),
+            "add-tags": input.tags?.join(","),
             "auth-token": token
         });
         await this.openThingsUrl(url);

package/dist/schemas/tool-schemas.js

@@ -43,6 +43,16 @@ export const listAreasInputSchema = z.object({
         .describe("Maximum items to return."),
     offset: z.number().int().min(0).default(0).describe("Pagination offset.")
 });
+export const listTagsInputSchema = z.object({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_PAGE_SIZE)
+        .default(DEFAULT_PAGE_SIZE)
+        .describe("Maximum tags to return."),
+    offset: z.number().int().min(0).default(0).describe("Pagination offset.")
+});
 export const searchTodosInputSchema = z.object({
     query: z.string().min(1).max(300).describe("Search query against todo title."),
     limit: z
@@ -79,6 +89,25 @@ export const projectTodosInputSchema = z.object({
         .describe("Maximum items to return."),
     offset: z.number().int().min(0).default(0).describe("Pagination offset.")
 });
+export const tagTodosToolInputSchema = z.object({
+    tag: z.string().min(1).max(300).optional().describe("Tag name."),
+    tagId: z.string().min(6).max(128).optional().describe("Tag ID."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_PAGE_SIZE)
+        .default(DEFAULT_PAGE_SIZE)
+        .describe("Maximum items to return."),
+    offset: z.number().int().min(0).default(0).describe("Pagination offset.")
+});
+export const tagTodosInputSchema = tagTodosToolInputSchema
+    .refine((value) => value.tag !== undefined || value.tagId !== undefined, {
+    message: "Provide tag or tagId."
+})
+    .refine((value) => !(value.tag !== undefined && value.tagId !== undefined), {
+    message: "Provide either tag or tagId, not both."
+});
 export const addAreaInputSchema = z.object({
     title: z.string().min(1).max(300).describe("Area title."),
     confirm: z
@@ -86,6 +115,28 @@ export const addAreaInputSchema = z.object({
         .default(false)
         .describe("Set true to confirm this write operation.")
 });
+export const addTagInputSchema = z.object({
+    title: z.string().min(1).max(300).describe("Tag title."),
+    confirm: z
+        .boolean()
+        .default(false)
+        .describe("Set true to confirm this write operation.")
+});
+export const updateTagInputSchema = z.object({
+    id: z.string().min(6).max(128).describe("Tag ID."),
+    title: z.string().min(1).max(300).describe("New tag title."),
+    confirm: z
+        .boolean()
+        .default(false)
+        .describe("Set true to confirm this write operation.")
+});
+export const deleteTagInputSchema = z.object({
+    id: z.string().min(6).max(128).describe("Tag ID."),
+    confirm: z
+        .boolean()
+        .default(false)
+        .describe("Set true to confirm this destructive operation.")
+});
 export const addTodoToolInputSchema = z.object({
     title: z.string().min(1).max(300).describe("Todo title."),
     notes: z.string().max(20_000).optional().describe("Todo notes."),

package/dist/services/things-service.js

@@ -1,3 +1,4 @@
+import { ValidationError } from "../errors.js";
 import { assertConfirm, assertSafeContainerName, assertSafeDate, assertSafeNotes, assertSafeTags, assertSafeTitle, assertThingsId } from "../utils/validators.js";
 export class ThingsService {
     appleScriptAdapter;
@@ -24,6 +25,9 @@ export class ThingsService {
     async listAreas(input) {
         return this.appleScriptAdapter.listAreas(input);
     }
+    async listTags(input) {
+        return this.appleScriptAdapter.listTags(input);
+    }
     async listAreaItems(input) {
         assertThingsId(input.areaId);
         const result = await this.appleScriptAdapter.listAreaItems(input);
@@ -42,6 +46,18 @@ export class ThingsService {
             items
         };
     }
+    async listTagTodos(input) {
+        if (input.tagId) {
+            assertThingsId(input.tagId);
+        }
+        assertSafeContainerName(input.tag);
+        const result = await this.appleScriptAdapter.listTagTodos(input);
+        const items = this.enrichSummaries(result.items);
+        return {
+            ...result,
+            items
+        };
+    }
     async searchTodos(input) {
         assertSafeTitle(input.query);
         const result = await this.appleScriptAdapter.searchTodos(input);
@@ -120,7 +136,17 @@ export class ThingsService {
         if (input.headingId) {
             assertThingsId(input.headingId);
         }
-        const requiresUrlScheme = input.heading !== undefined || input.headingId !== undefined;
+        if (input.tags !== undefined && input.tags.length > 0) {
+            const existingTags = await this.appleScriptAdapter.listTagNames();
+            const existingTagSet = new Set(existingTags.map((tag) => tag.trim().toLowerCase()));
+            const missingTags = input.tags.filter((tag) => !existingTagSet.has(tag.trim().toLowerCase()));
+            if (missingTags.length > 0) {
+                throw new ValidationError(`Tags not found in Things: ${missingTags.join(", ")}. Create these tags first, then retry update.`);
+            }
+        }
+        const requiresUrlScheme = input.heading !== undefined ||
+            input.headingId !== undefined ||
+            input.tags !== undefined;
         if (requiresUrlScheme) {
             await this.urlSchemeAdapter.updateTodo(input);
             return {
@@ -178,6 +204,34 @@ export class ThingsService {
             message: `Area created (${areaId || "id unavailable"}).`
         };
     }
+    async addTag(input) {
+        assertConfirm(input.confirm);
+        assertSafeTitle(input.title);
+        const tagId = await this.appleScriptAdapter.addTag(input);
+        return {
+            ok: true,
+            message: `Tag created (${tagId || "id unavailable"}).`
+        };
+    }
+    async updateTag(input) {
+        assertConfirm(input.confirm);
+        assertThingsId(input.id);
+        assertSafeTitle(input.title);
+        await this.appleScriptAdapter.updateTag(input);
+        return {
+            ok: true,
+            message: "Tag updated."
+        };
+    }
+    async deleteTag(input) {
+        assertConfirm(input.confirm);
+        assertThingsId(input.id);
+        await this.appleScriptAdapter.deleteTag(input);
+        return {
+            ok: true,
+            message: "Tag deleted."
+        };
+    }
     async showItem(input) {
         assertThingsId(input.id);
         await this.urlSchemeAdapter.showItem(input.id);

package/dist/tools/register-read-tools.js

@@ -1,4 +1,4 @@
-import { areaItemsInputSchema, emptyInputSchema, idInputSchema, listAreasInputSchema, listProjectsInputSchema, listTodosInputSchema, projectTodosInputSchema, searchTodosInputSchema, showItemInputSchema } from "../schemas/tool-schemas.js";
+import { areaItemsInputSchema, emptyInputSchema, idInputSchema, listAreasInputSchema, listProjectsInputSchema, listTagsInputSchema, tagTodosInputSchema, listTodosInputSchema, projectTodosInputSchema, searchTodosInputSchema, showItemInputSchema } from "../schemas/tool-schemas.js";
 import { toToolError, toToolSuccess } from "../utils/tool-response.js";
 export function registerReadTools(server, service) {
     server.registerTool("things_get_server_status", {
@@ -80,6 +80,26 @@ export function registerReadTools(server, service) {
             return toToolError(error);
         }
     });
+    server.registerTool("things_list_tags", {
+        title: "List Things Tags",
+        description: "List tags in Things with pagination.",
+        inputSchema: listTagsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false
+        }
+    }, async (params) => {
+        try {
+            const input = listTagsInputSchema.parse(params);
+            const data = await service.listTags(input);
+            return toToolSuccess(data);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
     server.registerTool("things_list_area_items", {
         title: "List Things Area Items",
         description: "List items (projects/todos) under an area.",
@@ -120,6 +140,26 @@ export function registerReadTools(server, service) {
             return toToolError(error);
         }
     });
+    server.registerTool("things_list_tag_todos", {
+        title: "List Things Tag Todos",
+        description: "List todos under a tag with pagination.",
+        inputSchema: tagTodosInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false
+        }
+    }, async (params) => {
+        try {
+            const input = tagTodosInputSchema.parse(params);
+            const data = await service.listTagTodos(input);
+            return toToolSuccess(data);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
     server.registerTool("things_search_todos", {
         title: "Search Things Todos",
         description: "Search todos by title with pagination.",

package/dist/tools/register-write-tools.js

@@ -1,4 +1,4 @@
-import { addAreaInputSchema, addProjectToolInputSchema, addTodoToolInputSchema, addProjectInputSchema, addTodoInputSchema, completeTodoInputSchema, deleteTodoInputSchema, moveTodoToolInputSchema, moveTodoInputSchema, updateTodoToolInputSchema, updateTodoInputSchema } from "../schemas/tool-schemas.js";
+import { addAreaInputSchema, addTagInputSchema, addProjectToolInputSchema, addTodoToolInputSchema, addProjectInputSchema, addTodoInputSchema, completeTodoInputSchema, deleteTagInputSchema, deleteTodoInputSchema, moveTodoToolInputSchema, moveTodoInputSchema, updateTagInputSchema, updateTodoToolInputSchema, updateTodoInputSchema } from "../schemas/tool-schemas.js";
 import { toToolError, toToolSuccess } from "../utils/tool-response.js";
 export function registerWriteTools(server, service) {
     server.registerTool("things_add_area", {
@@ -21,6 +21,26 @@ export function registerWriteTools(server, service) {
             return toToolError(error);
         }
     });
+    server.registerTool("things_add_tag", {
+        title: "Add Things Tag",
+        description: "Create a tag in Things. Requires confirm=true.",
+        inputSchema: addTagInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false
+        }
+    }, async (params) => {
+        try {
+            const input = addTagInputSchema.parse(params);
+            const data = await service.addTag(input);
+            return toToolSuccess(data);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
     server.registerTool("things_add_todo", {
         title: "Add Things Todo",
         description: "Create a todo in Things via URL scheme. Requires confirm=true.",
@@ -81,6 +101,26 @@ export function registerWriteTools(server, service) {
             return toToolError(error);
         }
     });
+    server.registerTool("things_update_tag", {
+        title: "Update Things Tag",
+        description: "Rename an existing tag. Requires confirm=true.",
+        inputSchema: updateTagInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false
+        }
+    }, async (params) => {
+        try {
+            const input = updateTagInputSchema.parse(params);
+            const data = await service.updateTag(input);
+            return toToolSuccess(data);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
     server.registerTool("things_complete_todo", {
         title: "Complete Things Todo",
         description: "Mark a todo as completed via URL scheme. Requires confirm=true.",
@@ -121,6 +161,26 @@ export function registerWriteTools(server, service) {
             return toToolError(error);
         }
     });
+    server.registerTool("things_delete_tag", {
+        title: "Delete Things Tag",
+        description: "Delete a tag. Requires confirm=true.",
+        inputSchema: deleteTagInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false
+        }
+    }, async (params) => {
+        try {
+            const input = deleteTagInputSchema.parse(params);
+            const data = await service.deleteTag(input);
+            return toToolSuccess(data);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
     server.registerTool("things_delete_todo", {
         title: "Delete Things Todo",
         description: "Delete a todo. Requires confirm=true.",

package/dist/utils/tool-response.js

@@ -7,8 +7,12 @@ export function toToolSuccess(data) {
 }
 export function toToolError(error) {
     const message = error instanceof Error ? redactSensitive(error.message) : "Unknown error";
+    const causeText = typeof error === "object" && error !== null && "causeText" in error
+        ? redactSensitive(String(error.causeText ?? ""))
+        : "";
+    const details = causeText.length > 0 ? `${message}\nCause: ${causeText}` : message;
     return {
         isError: true,
-        content: [{ type: "text", text: `Error: ${message}` }]
+        content: [{ type: "text", text: `Error: ${details}` }]
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "things-mcp-server",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "MCP server for controlling Things on macOS",
   "type": "module",
   "main": "dist/index.js",