keepsake-mcp 1.3.0 → 1.5.0

package/README.md

@@ -100,7 +100,7 @@ Add to `.cursor/mcp.json` in your project:
 }
 ```
 
-## Available tools (58)
+## Available tools (62)
 
 ### Contacts
 | Tool | Description |
@@ -165,12 +165,12 @@ Add to `.cursor/mcp.json` in your project:
 ### Tags
 | Tool | Description |
 |------|-------------|
-| `list_tags` | List all tags |
-| `get_tag` | Get a tag by ID with all properties (color, icon, view mode, etc.) |
+| `list_tags` | List tags (lightweight — ordering arrays omitted), with optional name search (`q`) |
+| `get_tag` | Get a tag by ID with all properties, including `tasks_order` (section markers `h:<header_id>`) |
 | `create_tag` | Create a new tag |
 | `update_tag` | Update a tag (name, description, color, icon, view mode, favorite) |
 | `delete_tag` | Permanently delete a tag and all its links |
-| `get_tag_items` | Get everything linked to a tag |
+| `get_tag_items` | Get items linked to a tag — filter by `types`/`status`, `summary` mode, task `sections` included |
 | `link_tag` | Link any entity to a tag |
 | `unlink_tag` | Remove a tag link |
 
@@ -192,6 +192,10 @@ Add to `.cursor/mcp.json` in your project:
 | `unlink_entry_contact` | Remove a contact link from an entry |
 | `link_task_contact` | Link a contact to a task |
 | `unlink_task_contact` | Remove a contact link from a task |
+| `link_task_note` | Link a note to a task (non-destructive, the note survives) |
+| `unlink_task_note` | Remove a note link from a task |
+| `link_notes` | Link two notes together (symmetric, non-destructive) |
+| `unlink_notes` | Remove the manual link between two notes |
 
 ### Utilities
 | Tool | Description |

package/build/tools.js

@@ -488,17 +488,18 @@ export function registerAllTools(server, fetchApi) {
     // TAGS
     // ===========================================================================
     server.registerTool("list_tags", {
-        description: "List all tags. Tags organize contacts, entries, tasks, notes, and companies.",
+        description: "List tags (lightweight: the manual tasks_order arrays are omitted — use get_tag for a tag's full ordering). Tags organize contacts, entries, tasks, notes, and companies. Use q to find a tag by name.",
         inputSchema: {
+            q: z.string().optional().describe("Filter by name (case-insensitive substring match)"),
             limit: z.number().int().positive().optional().describe("Max results (default 50)"),
             offset: z.number().int().nonnegative().optional().describe("Pagination offset"),
         },
         annotations: { title: "List tags", readOnlyHint: true, openWorldHint: false },
-    }, async ({ limit, offset }) => {
-        return toContent(await fetchApi(`/tags${qs({ limit, offset })}`));
+    }, async ({ q, limit, offset }) => {
+        return toContent(await fetchApi(`/tags${qs({ q, limit, offset })}`));
     });
     server.registerTool("get_tag", {
-        description: "Get a single tag by ID with all its properties (name, description, color, icon, view mode, favorite status).",
+        description: "Get a single tag by ID with all its properties (name, description, color, icon, view mode, favorite status). Includes tasks_order, the manual ordering of the tag page's task list, where entries of the form \"h:<header_id>\" are section separators (see list_task_headers).",
         inputSchema: {
             id: z.string().uuid().describe("Tag UUID"),
         },
@@ -507,13 +508,22 @@ export function registerAllTools(server, fetchApi) {
         return toContent(await fetchApi(`/tags/${id}`));
     });
     server.registerTool("get_tag_items", {
-        description: "Get all items linked to a specific tag: contacts, entries, tasks, notes, and companies with counts.",
+        description: "Get items linked to a tag. By default returns every type in full — on large tags that can be a huge response, so prefer types/status/summary to narrow it (e.g. types=['tasks'], status='pending', summary=true to review a project's open tasks). When tasks are included, the response also contains `sections`: the tag page's task sections with their task_ids (header_id null = tasks outside any section).",
         inputSchema: {
             id: z.string().uuid().describe("Tag UUID"),
+            types: z
+                .array(z.enum(["contacts", "entries", "tasks", "notes", "companies"]))
+                .optional()
+                .describe("Only fetch these item types (default: all)"),
+            status: z.enum(["pending", "completed"]).optional().describe("Filter tasks by status"),
+            summary: z
+                .boolean()
+                .optional()
+                .describe("Return lightweight items (ids, titles, excerpts) instead of full rows — recommended unless full content is needed"),
         },
         annotations: { title: "Get tag items", readOnlyHint: true, openWorldHint: false },
-    }, async ({ id }) => {
-        return toContent(await fetchApi(`/tags/${id}/items`));
+    }, async ({ id, types, status, summary }) => {
+        return toContent(await fetchApi(`/tags/${id}/items${qs({ types: types?.join(","), status, summary })}`));
     });
     server.registerTool("create_tag", {
         description: "A TAG is a thematic grouping space. Syntax: #name# or [[name]]. Groups notes, entries, tasks, and contacts.\n\nCreate a new tag. If a tag with the same name already exists, returns the existing tag.",
@@ -692,6 +702,46 @@ export function registerAllTools(server, fetchApi) {
     }, async ({ task_id, contact_id }) => {
         return toContent(await fetchApi(`/tasks/${task_id}/contacts/${contact_id}`, "DELETE"));
     });
+    server.registerTool("link_task_note", {
+        description: "Link an existing note to a task (non-destructive, N-N). The note stays in the inbox/notes list and the task keeps a live link back to it — use this instead of deleting a note after creating a task from it. The note shows its linked tasks; the task shows the source note.",
+        inputSchema: {
+            task_id: z.string().uuid().describe("Task UUID"),
+            note_id: z.string().uuid().describe("Note UUID"),
+        },
+        annotations: { title: "Link task note", destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ task_id, note_id }) => {
+        return toContent(await fetchApi(`/tasks/${task_id}/notes/${note_id}`, "POST"));
+    });
+    server.registerTool("unlink_task_note", {
+        description: "Remove the link between a note and a task. Both the task and the note survive.",
+        inputSchema: {
+            task_id: z.string().uuid().describe("Task UUID"),
+            note_id: z.string().uuid().describe("Note UUID"),
+        },
+        annotations: { title: "Unlink task note", destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ task_id, note_id }) => {
+        return toContent(await fetchApi(`/tasks/${task_id}/notes/${note_id}`, "DELETE"));
+    });
+    server.registerTool("link_notes", {
+        description: "Link two notes together (knowledge base, N-N, non-destructive). The link is symmetric: both notes list each other in their linked-notes section. Use this to connect related ideas — e.g. a note that made you think of another one. Notes can also be linked inline by writing [label](note:uuid) in a note's content.",
+        inputSchema: {
+            note_id: z.string().uuid().describe("First note UUID"),
+            target_note_id: z.string().uuid().describe("Second note UUID"),
+        },
+        annotations: { title: "Link notes", destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ note_id, target_note_id }) => {
+        return toContent(await fetchApi(`/notes/${note_id}/links/${target_note_id}`, "POST"));
+    });
+    server.registerTool("unlink_notes", {
+        description: "Remove the manual link between two notes (both notes survive). Links derived from inline [label](note:uuid) markdown in a note's content are preserved — edit the content to remove those.",
+        inputSchema: {
+            note_id: z.string().uuid().describe("First note UUID"),
+            target_note_id: z.string().uuid().describe("Second note UUID"),
+        },
+        annotations: { title: "Unlink notes", destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ note_id, target_note_id }) => {
+        return toContent(await fetchApi(`/notes/${note_id}/links/${target_note_id}`, "DELETE"));
+    });
     // ===========================================================================
     // CONTACT TIMELINE
     // ===========================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keepsake-mcp",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "MCP server for Keepsake personal CRM — connect your AI agent to your contacts, tasks, notes, and more",
   "type": "module",
   "bin": {