keepsake-mcp 1.13.0 → 1.14.0

package/README.md

@@ -188,9 +188,9 @@ Material kept *alongside* a note without entering its text — an idea, a refere
 ### Days (intention or question of the day)
 | Tool | Description |
 |------|-------------|
-| `list_days` | List days with their intention or question of the day, by date range |
-| `get_day` | Get a day and its intention or question (field `note`) |
-| `update_day` | Set a day's intention or question — one short line, not a journal (upsert) |
+| `list_days` | List days with their intention or question of the day (the one in force, which stays until changed), by date range |
+| `get_day` | Get a day, its intention in force (`intention`, carried over until changed) and what was written that day (`note`) |
+| `update_day` | Set a day's intention or question — one short line, not a journal (upsert); it stays in place on the following days until changed |
 
 ### Day blocks (Day-view timeline)
 | Tool | Description |

package/build/tools.js

@@ -657,7 +657,7 @@ export function registerAllTools(server, fetchApi) {
     // DAYS (Daily Summaries)
     // ===========================================================================
     server.registerTool("list_days", {
-        description: "List days with their intention or question of the day (field `note`). Filter by date range.",
+        description: "List stored days with their intention or question of the day. An intention stays in place until changed: `intention` is the one in force that day (the last one written on that day or before, `intention_date` = when it was written); `note` is what was written on that exact day (null = nothing written). Filter by date range.",
         inputSchema: {
             from: z.string().optional().describe("Start date (YYYY-MM-DD)"),
             to: z.string().optional().describe("End date (YYYY-MM-DD)"),
@@ -669,7 +669,7 @@ export function registerAllTools(server, fetchApi) {
         return toContent(await fetchApi(`/days${qs({ from, to, limit, offset })}`));
     });
     server.registerTool("get_day", {
-        description: "Get a specific day by date: its intention or question of the day (field `note`, one short line) AND the notes linked to that day (field `notes`, via link_note_date / `dates`). Always 200 — `exists: false` means no intention is stored yet, the linked notes are returned regardless.",
+        description: "Get a specific day by date: its intention or question of the day AND the notes linked to that day (field `notes`, via link_note_date / `dates`). An intention stays in place until changed: `intention` is the one in force that day, as the user sees it (the last one written on that day or before; `intention_date` = the day it was written), while `note` is what was written on that exact day (null = nothing written there, '' = intention stopped from that day). Always 200 — `exists: false` means no row is stored for that date; `intention` and the linked notes are returned regardless.",
         inputSchema: {
             date: z.string().describe("Date (YYYY-MM-DD)"),
         },
@@ -678,10 +678,10 @@ export function registerAllTools(server, fetchApi) {
         return toContent(await fetchApi(`/days/${date}`));
     });
     server.registerTool("update_day", {
-        description: "Create or update a day's intention or question of the day (upsert on the date). The `note` field is the intention or question of the day — one short line at the top of the Today view (a mantra, an intention, a single priority, or a question to keep in mind). Not a journal: never write a summary of the day here.\n\nNOT for attaching a note to a day: this field is a single line and you would overwrite the user's intention. To put a note on a day, use create_note with `dates` or link_note_date.",
+        description: "Create or update a day's intention or question of the day (upsert on the date). The `note` field is the intention or question of the day — one short line at the top of the Today view (a mantra, an intention, a single priority, or a question to keep in mind). Not a journal: never write a summary of the day here.\n\nAn intention stays in place until changed: writing it on a day replaces the intention from that day onward (following days show it too, until the next day with its own intention — set one on a future date for a one-off, e.g. before a meeting). `null` removes what was written on that day (the day goes back to the intention in force before it); an empty string stops any intention from that day onward. Check `intention` with get_day before writing: you may be replacing a long-running intention the user cares about.\n\nNOT for attaching a note to a day: this field is a single line and you would overwrite the user's intention. To put a note on a day, use create_note with `dates` or link_note_date.",
         inputSchema: {
             date: z.string().describe("Date (YYYY-MM-DD)"),
-            note: z.string().describe("The intention or question of the day: one short line (mantra, intention, single priority, or a question to keep in mind). Not a journal summary."),
+            note: z.string().nullable().describe("The intention or question of the day: one short line (mantra, intention, single priority, or a question to keep in mind). Not a journal summary. null = remove what was written on this day (back to the previous intention); empty string = stop any intention from this day onward."),
         },
         annotations: { title: "Update day", destructiveHint: false, idempotentHint: true, openWorldHint: false },
     }, async (params) => {

package/package.json

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