keepsake-mcp 1.11.0 → 1.12.0

package/README.md

@@ -114,7 +114,7 @@ rather than in the chat, which disappears.
 |--------|-----------|-------------|
 | `review_note` | `note_id` | Act as the editor of a note: read it, judge form and substance, leave anchored remarks in the margin, never rewrite the text |
 
-## Available tools (76)
+## Available tools (83)
 
 ### Contacts
 | Tool | Description |
@@ -152,6 +152,7 @@ rather than in the chat, which disappears.
 | Tool | Description |
 |------|-------------|
 | `list_tasks` | List tasks with status/date filters |
+| `get_task` | Get a task with its tags, contacts, companies and linked notes |
 | `create_task` | Create a task — supports `#tag#` and `[[tag]]` syntax |
 | `update_task` | Update task fields |
 | `delete_task` | Delete a task |
@@ -220,13 +221,16 @@ Material kept *alongside* a note without entering its text — an idea, a refere
 | `update_task_header` | Update a task header (name, description, collapsed) |
 | `delete_task_header` | Permanently delete a task header |
 
-### Contact Links
+### Contact & company links
 | Tool | Description |
 |------|-------------|
+| `link_note_company` / `unlink_note_company` | Link / unlink a company to a note |
 | `link_note_contact` | Link a contact to a note |
 | `unlink_note_contact` | Remove a contact link from a note |
+| `link_entry_company` / `unlink_entry_company` | Add / remove a company as participant of an entry |
 | `link_entry_contact` | Link a contact to an entry |
 | `unlink_entry_contact` | Remove a contact link from an entry |
+| `link_task_company` / `unlink_task_company` | Link / unlink a company to a task |
 | `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) |

package/build/tools.js

@@ -302,14 +302,15 @@ export function registerAllTools(server, fetchApi) {
                 .optional()
                 .describe("Filter by entry type"),
             contact_id: z.string().uuid().optional().describe("Filter by associated contact ID"),
+            company_id: z.string().uuid().optional().describe("Only entries where this company is a participant"),
             from: z.string().optional().describe("Start date (YYYY-MM-DD)"),
             to: z.string().optional().describe("End date (YYYY-MM-DD)"),
             limit: z.number().int().positive().optional().describe("Max results (default 20)"),
             offset: z.number().int().nonnegative().optional().describe("Pagination offset"),
         },
         annotations: { title: "List entries", readOnlyHint: true, openWorldHint: false },
-    }, async ({ type, contact_id, from, to, limit, offset }) => {
-        return toContent(await fetchApi(`/entries${qs({ type, contact_id, from, to, limit, offset })}`));
+    }, async ({ type, contact_id, company_id, from, to, limit, offset }) => {
+        return toContent(await fetchApi(`/entries${qs({ type, contact_id, company_id, from, to, limit, offset })}`));
     });
     server.registerTool("create_entry", {
         description: "An ENTRY is a dated interaction log tied to contacts. Records something that happened (call, meeting, email…) on a specific date.\n\nCreate a new interaction entry. Content supports #tag# and [[tag]] syntax for automatic tag linking.",
@@ -323,6 +324,10 @@ export function registerAllTools(server, fetchApi) {
                 .array(z.string().uuid())
                 .optional()
                 .describe("Array of contact UUIDs to associate"),
+            company_ids: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Array of company UUIDs to associate (companies are separate from contacts)"),
             tag_ids: z
                 .array(z.string().uuid())
                 .optional()
@@ -346,6 +351,10 @@ export function registerAllTools(server, fetchApi) {
                 .array(z.string().uuid())
                 .optional()
                 .describe("Replace associated contacts"),
+            company_ids: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Replace associated companies (send [] to unlink all). Contacts are unaffected."),
             tag_ids: z
                 .array(z.string().uuid())
                 .optional()
@@ -376,12 +385,22 @@ export function registerAllTools(server, fetchApi) {
                 .optional()
                 .describe("Filter by date type: specific (has a due date), asap (do as soon as possible), one_day (someday/no rush)"),
             date: z.string().optional().describe("Filter by specific date (YYYY-MM-DD)"),
+            company_id: z.string().uuid().optional().describe("Only tasks linked directly to this company"),
             limit: z.number().int().positive().optional().describe("Max results (default 20)"),
             offset: z.number().int().nonnegative().optional().describe("Pagination offset"),
         },
         annotations: { title: "List tasks", readOnlyHint: true, openWorldHint: false },
-    }, async ({ status, date_type, date, limit, offset }) => {
-        return toContent(await fetchApi(`/tasks${qs({ status, date_type, date, limit, offset })}`));
+    }, async ({ status, date_type, date, company_id, limit, offset }) => {
+        return toContent(await fetchApi(`/tasks${qs({ status, date_type, date, company_id, limit, offset })}`));
+    });
+    server.registerTool("get_task", {
+        description: "Get a single task by ID, with its tags, linked contacts (contact_ids), linked companies (company_ids) and linked notes (note_ids). Use it when you already know which task you need instead of listing everything.",
+        inputSchema: {
+            id: z.string().uuid().describe("Task UUID"),
+        },
+        annotations: { title: "Get task", readOnlyHint: true, openWorldHint: false },
+    }, async ({ id }) => {
+        return toContent(await fetchApi(`/tasks/${id}`));
     });
     server.registerTool("create_task", {
         description: "A TASK is an action item to accomplish. Can have due date, recurrence, priority, linked to contacts and tags.\n\nCreate a new task. Title supports #tag# and [[tag]] for automatic tag linking.",
@@ -420,6 +439,10 @@ export function registerAllTools(server, fetchApi) {
                 .array(z.string().uuid())
                 .optional()
                 .describe("Array of contact UUIDs to associate"),
+            company_ids: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Array of company UUIDs to associate (companies are separate from contacts)"),
             tag_ids: z
                 .array(z.string().uuid())
                 .optional()
@@ -459,6 +482,10 @@ export function registerAllTools(server, fetchApi) {
                 .array(z.string().uuid())
                 .optional()
                 .describe("Replace associated contacts"),
+            company_ids: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Replace associated companies (send [] to unlink all). Contacts are unaffected."),
             tag_ids: z
                 .array(z.string().uuid())
                 .optional()
@@ -520,12 +547,13 @@ export function registerAllTools(server, fetchApi) {
             date: z.string().optional().describe("Only notes linked to this day (YYYY-MM-DD)"),
             date_from: z.string().optional().describe("Only notes linked to a day on or after this date (YYYY-MM-DD)"),
             date_to: z.string().optional().describe("Only notes linked to a day on or before this date (YYYY-MM-DD)"),
+            company_id: z.string().uuid().optional().describe("Only notes linked directly to this company"),
             limit: z.number().int().positive().optional().describe("Max results (default 20)"),
             offset: z.number().int().nonnegative().optional().describe("Pagination offset"),
         },
         annotations: { title: "List notes", readOnlyHint: true, openWorldHint: false },
-    }, async ({ pinned, archived, date, date_from, date_to, limit, offset }) => {
-        return toContent(await fetchApi(`/notes${qs({ pinned, archived, date, date_from, date_to, limit, offset })}`));
+    }, async ({ pinned, archived, date, date_from, date_to, company_id, limit, offset }) => {
+        return toContent(await fetchApi(`/notes${qs({ pinned, archived, date, date_from, date_to, company_id, limit, offset })}`));
     });
     server.registerTool("get_note", {
         description: "Get a single note by ID, including its tags, linked contacts, linked tasks, linked notes and the days it is linked to (`dates`). Use this when the user points you at one specific note (e.g. gives you its URL — the UUID is the last path segment) instead of listing everything.",
@@ -545,6 +573,10 @@ export function registerAllTools(server, fetchApi) {
                 .array(z.string().uuid())
                 .optional()
                 .describe("Array of contact UUIDs to associate"),
+            company_ids: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Array of company UUIDs to associate (companies are separate from contacts)"),
             dates: z
                 .array(z.string())
                 .optional()
@@ -563,6 +595,10 @@ export function registerAllTools(server, fetchApi) {
                 .array(z.string().uuid())
                 .optional()
                 .describe("Replace associated contacts"),
+            company_ids: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Replace associated companies (send [] to unlink all). Contacts are unaffected."),
             tag_ids: z
                 .array(z.string().uuid())
                 .optional()
@@ -939,6 +975,66 @@ export function registerAllTools(server, fetchApi) {
     }, async ({ task_id, contact_id }) => {
         return toContent(await fetchApi(`/tasks/${task_id}/contacts/${contact_id}`, "DELETE"));
     });
+    server.registerTool("link_entry_company", {
+        description: "Link a company to an entry (the company becomes a participant of that interaction). Idempotent. Companies are separate records from contacts: use this (or company_ids) for an organization, link_entry_contact for a person.",
+        inputSchema: {
+            entry_id: z.string().uuid().describe("Entry UUID"),
+            company_id: z.string().uuid().describe("Company UUID"),
+        },
+        annotations: { title: "Link entry company", destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ entry_id, company_id }) => {
+        return toContent(await fetchApi(`/entries/${entry_id}/companies/${company_id}`, "POST"));
+    });
+    server.registerTool("unlink_entry_company", {
+        description: "Remove the link between a company and an entry.",
+        inputSchema: {
+            entry_id: z.string().uuid().describe("Entry UUID"),
+            company_id: z.string().uuid().describe("Company UUID"),
+        },
+        annotations: { title: "Unlink entry company", destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ entry_id, company_id }) => {
+        return toContent(await fetchApi(`/entries/${entry_id}/companies/${company_id}`, "DELETE"));
+    });
+    server.registerTool("link_task_company", {
+        description: "Link a company to a task. Idempotent. Companies are separate records from contacts: use this (or company_ids) for an organization, link_task_contact for a person.",
+        inputSchema: {
+            task_id: z.string().uuid().describe("Task UUID"),
+            company_id: z.string().uuid().describe("Company UUID"),
+        },
+        annotations: { title: "Link task company", destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ task_id, company_id }) => {
+        return toContent(await fetchApi(`/tasks/${task_id}/companies/${company_id}`, "POST"));
+    });
+    server.registerTool("unlink_task_company", {
+        description: "Remove the link between a company and a task.",
+        inputSchema: {
+            task_id: z.string().uuid().describe("Task UUID"),
+            company_id: z.string().uuid().describe("Company UUID"),
+        },
+        annotations: { title: "Unlink task company", destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ task_id, company_id }) => {
+        return toContent(await fetchApi(`/tasks/${task_id}/companies/${company_id}`, "DELETE"));
+    });
+    server.registerTool("link_note_company", {
+        description: "Link a company to a note. Idempotent. Companies are separate records from contacts: use this (or company_ids) for an organization, link_note_contact for a person.",
+        inputSchema: {
+            note_id: z.string().uuid().describe("Note UUID"),
+            company_id: z.string().uuid().describe("Company UUID"),
+        },
+        annotations: { title: "Link note company", destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ note_id, company_id }) => {
+        return toContent(await fetchApi(`/notes/${note_id}/companies/${company_id}`, "POST"));
+    });
+    server.registerTool("unlink_note_company", {
+        description: "Remove the link between a company and a note.",
+        inputSchema: {
+            note_id: z.string().uuid().describe("Note UUID"),
+            company_id: z.string().uuid().describe("Company UUID"),
+        },
+        annotations: { title: "Unlink note company", destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ note_id, company_id }) => {
+        return toContent(await fetchApi(`/notes/${note_id}/companies/${company_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: {

package/package.json

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