seekstone 0.7.1 → 0.8.0

package/README.md

@@ -8,6 +8,8 @@ It reads your vault **directly from disk** instead of routing through the Obsidi
 
 (Previously also published as `obsidian-mcp-seekstone` — that alias is deprecated; existing installs keep working, but install `seekstone` going forward.)
 
+[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/shaqmughal/seekstone/releases/latest/download/seekstone.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=seekstone&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNlZWtzdG9uZSJdLCJlbnYiOnsiU0VFS1NUT05FX1ZBVUxUIjoiL2Fic29sdXRlL3BhdGgvdG8veW91ci92YXVsdCJ9fQ%3D%3D) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22seekstone%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22seekstone%22%5D%2C%22env%22%3A%7B%22SEEKSTONE_VAULT%22%3A%22%2Fabsolute%2Fpath%2Fto%2Fyour%2Fvault%22%7D%7D)
+
 ---
 
 ## Install
@@ -64,6 +66,26 @@ Add to `claude_desktop_config.json` (Settings → Developer → Edit Config):
 claude mcp add seekstone --env SEEKSTONE_VAULT=/absolute/path/to/your/vault -- npx -y seekstone
 ```
 
+### Option 5 — Cursor
+
+One-click via the [Install in Cursor](https://cursor.com/install-mcp?name=seekstone&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNlZWtzdG9uZSJdLCJlbnYiOnsiU0VFS1NUT05FX1ZBVUxUIjoiL2Fic29sdXRlL3BhdGgvdG8veW91ci92YXVsdCJ9fQ%3D%3D) link above (then set `SEEKSTONE_VAULT` to your vault path), or let the CLI auto-detect your vault:
+
+```bash
+npx -y seekstone init --client cursor --write
+```
+
+Or add the Option 3 JSON block to `~/.cursor/mcp.json`.
+
+### Option 6 — VS Code
+
+One-click via the [Install in VS Code](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22seekstone%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22seekstone%22%5D%2C%22env%22%3A%7B%22SEEKSTONE_VAULT%22%3A%22%2Fabsolute%2Fpath%2Fto%2Fyour%2Fvault%22%7D%7D) link above (then set `SEEKSTONE_VAULT` to your vault path), or from the terminal:
+
+```bash
+code --add-mcp '{"name":"seekstone","command":"npx","args":["-y","seekstone"],"env":{"SEEKSTONE_VAULT":"/absolute/path/to/your/vault"}}'
+```
+
+Other MCP clients (Windsurf, Cline, …) take the Option 3 JSON block in their own MCP config file.
+
 ---
 
 ## Tools

package/dist/index.js

@@ -21,18 +21,18 @@ function helpText(version) {
   return `seekstone ${version} \u2014 an Obsidian MCP server (filesystem-direct, low context-tax)
 
 Seekstone runs as a Model Context Protocol stdio server. It is normally
-launched by an MCP client (Claude Desktop, Claude Code), not run by hand.
+launched by an MCP client (Claude Desktop, Claude Code, Cursor, \u2026), not run by hand.
 
 Usage:
   seekstone            Start the MCP server (reads from stdin/stdout)
-  seekstone init       Validate a vault and print/patch the Claude config
+  seekstone init       Validate a vault and print/patch the client MCP config
   seekstone --version  Print the version and exit
   seekstone --help     Print this help and exit
 
 "seekstone init" options:
   --vault <path>       Vault to use (auto-detected from Obsidian if omitted; fallback: $SEEKSTONE_VAULT)
-  --client <name>      desktop (default) | code
-  --write              Patch the Claude Desktop config in place (backs it up first)
+  --client <name>      desktop (default) | code | cursor
+  --write              Patch the client config in place (backs it up first)
 
 Required environment:
   SEEKSTONE_VAULT      Absolute path to your Obsidian vault
@@ -206,6 +206,7 @@ function buildDoc(relPath, raw) {
     body: fm.body,
     tags: allTags.join(" "),
     fmKeys: fm.keys.join(" "),
+    fm: fm.data,
     raw,
     sizeBytes: Buffer.byteLength(raw, "utf8"),
     mtimeMs: Date.now()
@@ -897,19 +898,224 @@ async function appendPeriodicNote(ctx2, rawInput) {
   return { path: path2, bytesWritten: Buffer.byteLength(newRaw, "utf8") };
 }
 
+// src/tools/query_notes.ts
+import { z as z14 } from "zod";
+
+// src/tools/search.ts
+import { z as z13 } from "zod";
+
+// src/index/excerpt.ts
+function extractExcerpt(text, terms, maxLen = 200) {
+  const lower = text.toLowerCase();
+  let bestIdx = -1;
+  for (const term of terms) {
+    const idx = lower.indexOf(term.toLowerCase());
+    if (idx !== -1 && (bestIdx === -1 || idx < bestIdx)) {
+      bestIdx = idx;
+    }
+  }
+  if (bestIdx === -1) {
+    return truncate(text.trimStart(), maxLen);
+  }
+  const half = Math.floor(maxLen / 2);
+  const start = Math.max(0, bestIdx - half);
+  const end = Math.min(text.length, bestIdx + half + (terms[0]?.length ?? 0));
+  const slice = text.slice(start, end).trim();
+  return `${start > 0 ? "\u2026" : ""}${slice}${end < text.length ? "\u2026" : ""}`;
+}
+function truncate(s, max) {
+  if (s.length <= max) return s;
+  return `${s.slice(0, max).trimEnd()}\u2026`;
+}
+
+// src/tools/search.ts
+var SearchInput = z13.object({
+  query: z13.string().min(1).describe("Search query. Supports fuzzy matching and prefix search."),
+  limit: z13.number().int().min(1).max(50).default(10).describe("Maximum number of results to return."),
+  folder: z13.string().optional().describe("Restrict results to notes under this vault-relative folder prefix."),
+  tag: z13.string().optional().describe("Restrict results to notes containing this tag."),
+  excerptLength: z13.number().int().min(20).max(2e3).optional().describe(
+    "Max characters of match context per hit (default 120). Lower trims payload; higher gives more context."
+  )
+});
+function basenameNoExt(path2) {
+  const base = path2.slice(path2.lastIndexOf("/") + 1);
+  const dot = base.lastIndexOf(".");
+  return dot > 0 ? base.slice(0, dot) : base;
+}
+function search(ctx2, input) {
+  const results = ctx2.index.search(input.query, {
+    boost: { title: 3, tags: 2, body: 1 },
+    fuzzy: 0.2,
+    prefix: true
+  });
+  const terms = input.query.toLowerCase().split(/\s+/).filter((t) => t.length > 1);
+  const hits = [];
+  for (const r of results) {
+    if (input.folder && !r.id.startsWith(input.folder)) continue;
+    if (input.tag) {
+      const note2 = ctx2.notes.get(r.id);
+      if (!note2) continue;
+      const noteTags2 = note2.tags.split(" ");
+      if (!noteTags2.some((t) => t === input.tag || t === input.tag?.replace(/^#/, ""))) continue;
+    }
+    const note = ctx2.notes.get(r.id);
+    const body = note?.body ?? "";
+    const noteTags = note?.tags ? note.tags.split(" ").filter(Boolean) : [];
+    const title = r.title;
+    const hit = {
+      path: r.id,
+      // Round the raw MiniSearch score: 2 decimals preserve relevance gaps without 17-digit float tax.
+      score: Math.round(r.score * 100) / 100,
+      excerpt: extractExcerpt(body, terms, input.excerptLength ?? 120)
+    };
+    if (title && title !== basenameNoExt(r.id)) hit.title = title;
+    if (noteTags.length > 0) hit.tags = noteTags;
+    hits.push(hit);
+    if (hits.length >= input.limit) break;
+  }
+  return hits;
+}
+
+// src/tools/query_notes.ts
+var OPS_WITHOUT_VALUE = /* @__PURE__ */ new Set(["exists", "missing"]);
+var Predicate = z14.object({
+  key: z14.string().min(1).describe("Frontmatter key to test (top-level)."),
+  op: z14.enum(["eq", "ne", "contains", "exists", "missing", "gt", "gte", "lt", "lte"]).describe(
+    "eq/ne compare scalars; contains matches array membership or substring; exists/missing test key presence; gt/gte/lt/lte compare numbers or strings (ISO dates sort correctly)."
+  ),
+  value: z14.union([z14.string(), z14.number(), z14.boolean()]).optional().describe("Comparison value. Required for every op except exists/missing.")
+}).refine((p) => OPS_WITHOUT_VALUE.has(p.op) || p.value !== void 0, {
+  message: "value is required for this op"
+});
+var ISO_DATE = z14.string().refine((s) => !Number.isNaN(Date.parse(s)), { message: "not a parseable date" });
+var QueryNotesInput = z14.object({
+  where: z14.array(Predicate).max(20).default([]).describe("Frontmatter predicates. All must match (AND)."),
+  folder: z14.string().optional().describe("Restrict to notes under this vault-relative folder prefix."),
+  tag: z14.string().optional().describe("Restrict to notes with this tag (# prefix optional)."),
+  modifiedAfter: ISO_DATE.optional().describe(
+    "Only notes modified at or after this ISO 8601 date/time."
+  ),
+  modifiedBefore: ISO_DATE.optional().describe(
+    "Only notes modified before this ISO 8601 date/time."
+  ),
+  minSizeBytes: z14.number().int().min(0).optional().describe("Only notes at least this many bytes."),
+  maxSizeBytes: z14.number().int().min(0).optional().describe("Only notes at most this many bytes."),
+  select: z14.array(z14.string()).max(20).default([]).describe(
+    'Extra fields to return per hit: frontmatter keys, or the specials "mtime", "size", "tags". Default returns only path + title, keeping the payload minimal.'
+  ),
+  sort: z14.enum(["path", "title", "mtime", "size"]).default("path").describe("Sort field."),
+  order: z14.enum(["asc", "desc"]).default("asc").describe("Sort order."),
+  limit: z14.number().int().min(1).max(500).default(100).describe("Maximum number of results.")
+});
+function scalarEq(a, b) {
+  if (a === b) return true;
+  if (a === null || a === void 0 || typeof a === "object") return false;
+  return String(a) === String(b);
+}
+function compare(a, b) {
+  if (a === null || a === void 0 || typeof a === "object" || typeof a === "boolean") {
+    return void 0;
+  }
+  const an = Number(a);
+  const bn = Number(b);
+  if (Number.isFinite(an) && Number.isFinite(bn)) return an - bn;
+  const as = String(a);
+  const bs = String(b);
+  return as < bs ? -1 : as > bs ? 1 : 0;
+}
+function matches(fm, p) {
+  const val = fm?.[p.key];
+  switch (p.op) {
+    case "exists":
+      return val !== void 0;
+    case "missing":
+      return val === void 0;
+    case "eq":
+      return scalarEq(val, p.value);
+    // `ne` requires the key to exist — notes without the key don't match.
+    case "ne":
+      return val !== void 0 && !scalarEq(val, p.value);
+    case "contains": {
+      if (Array.isArray(val)) return val.some((v) => scalarEq(v, p.value));
+      if (typeof val === "string") {
+        return val.toLowerCase().includes(String(p.value).toLowerCase());
+      }
+      return false;
+    }
+    case "gt":
+    case "gte":
+    case "lt":
+    case "lte": {
+      const c = compare(val, p.value);
+      if (c === void 0) return false;
+      if (p.op === "gt") return c > 0;
+      if (p.op === "gte") return c >= 0;
+      if (p.op === "lt") return c < 0;
+      return c <= 0;
+    }
+  }
+}
+function queryNotes(ctx2, input) {
+  const tag = input.tag?.replace(/^#/, "");
+  const after = input.modifiedAfter ? Date.parse(input.modifiedAfter) : void 0;
+  const before = input.modifiedBefore ? Date.parse(input.modifiedBefore) : void 0;
+  const fmKeys = input.select.filter((s) => s !== "mtime" && s !== "size" && s !== "tags");
+  const hits = [];
+  for (const [path2, note] of ctx2.notes) {
+    if (input.folder && !path2.startsWith(input.folder)) continue;
+    if (tag && !note.tags.split(" ").filter(Boolean).includes(tag)) continue;
+    if (after !== void 0 && note.mtimeMs < after) continue;
+    if (before !== void 0 && note.mtimeMs >= before) continue;
+    if (input.minSizeBytes !== void 0 && note.sizeBytes < input.minSizeBytes) continue;
+    if (input.maxSizeBytes !== void 0 && note.sizeBytes > input.maxSizeBytes) continue;
+    if (!input.where.every((p) => matches(note.fm, p))) continue;
+    const hit = { path: path2 };
+    if (note.title && note.title !== basenameNoExt(path2)) hit.title = note.title;
+    if (input.select.includes("mtime")) hit.mtime = new Date(note.mtimeMs).toISOString();
+    if (input.select.includes("size")) hit.sizeBytes = note.sizeBytes;
+    if (input.select.includes("tags")) {
+      const noteTags = note.tags.split(" ").filter(Boolean);
+      if (noteTags.length > 0) hit.tags = noteTags;
+    }
+    if (fmKeys.length > 0 && note.fm) {
+      const fm = {};
+      for (const k of fmKeys) {
+        if (note.fm[k] !== void 0) fm[k] = note.fm[k];
+      }
+      if (Object.keys(fm).length > 0) hit.fm = fm;
+    }
+    hits.push({ hit, note });
+  }
+  const dir = input.order === "desc" ? -1 : 1;
+  hits.sort((a, b) => {
+    switch (input.sort) {
+      case "mtime":
+        return (a.note.mtimeMs - b.note.mtimeMs) * dir;
+      case "size":
+        return (a.note.sizeBytes - b.note.sizeBytes) * dir;
+      case "title":
+        return a.note.title.localeCompare(b.note.title) * dir;
+      default:
+        return a.hit.path.localeCompare(b.hit.path) * dir;
+    }
+  });
+  return hits.slice(0, input.limit).map((h) => h.hit);
+}
+
 // src/tools/read_note.ts
 import { readFile as readFile6 } from "fs/promises";
 import { join as join11 } from "path";
-import { z as z13 } from "zod";
-var ReadNoteInput = z13.object({
-  path: z13.string().describe('Vault-relative path to the note, e.g. "Daily Notes/2026-05-29.md".'),
-  section: z13.string().optional().describe("Return only this heading section (heading text, # prefix optional)."),
-  block: z13.string().optional().describe("Return only the block anchored by this id (^ prefix optional)."),
-  lines: z13.object({
-    from: z13.number().int().min(1).describe("First line (1-indexed, inclusive)."),
-    to: z13.number().int().min(1).optional().describe("Last line (1-indexed, inclusive). Defaults to end of file.")
+import { z as z15 } from "zod";
+var ReadNoteInput = z15.object({
+  path: z15.string().describe('Vault-relative path to the note, e.g. "Daily Notes/2026-05-29.md".'),
+  section: z15.string().optional().describe("Return only this heading section (heading text, # prefix optional)."),
+  block: z15.string().optional().describe("Return only the block anchored by this id (^ prefix optional)."),
+  lines: z15.object({
+    from: z15.number().int().min(1).describe("First line (1-indexed, inclusive)."),
+    to: z15.number().int().min(1).optional().describe("Last line (1-indexed, inclusive). Defaults to end of file.")
   }).optional().describe("Return only this line range (1-indexed, inclusive)."),
-  includeFrontmatter: z13.boolean().optional().describe(
+  includeFrontmatter: z15.boolean().optional().describe(
     "Include frontmatter in span results. Default false for section/block spans. No effect on lines or whole-note reads."
   )
 }).refine((v) => [v.section, v.block, v.lines].filter((x) => x !== void 0).length <= 1, {
@@ -1002,16 +1208,16 @@ async function readNote(ctx2, input) {
 // src/tools/replace_in_note.ts
 import { readFile as readFile7, rename as rename3, writeFile as writeFile6 } from "fs/promises";
 import { join as join12 } from "path";
-import { z as z14 } from "zod";
-var ReplaceInNoteInput = z14.object({
-  path: z14.string().describe("Vault-relative path to the note."),
-  find: z14.string().min(1).max(1e3).describe("Text or pattern to find (max 1000 chars; bounds regex-mode pattern size)."),
-  replace: z14.string().describe("Replacement text. Supports $1, $2, \u2026 backreferences in regex mode."),
-  regex: z14.boolean().default(false).describe("Treat find as a regular expression."),
-  caseSensitive: z14.boolean().default(false).describe("Case-sensitive matching."),
-  wholeWord: z14.boolean().default(false).describe("Match whole words only (\\b word-boundary)."),
-  limit: z14.number().int().min(1).optional().describe("Maximum number of replacements. Omit to replace all."),
-  dryRun: z14.boolean().default(false).describe("If true, report matches without writing anything.")
+import { z as z16 } from "zod";
+var ReplaceInNoteInput = z16.object({
+  path: z16.string().describe("Vault-relative path to the note."),
+  find: z16.string().min(1).max(1e3).describe("Text or pattern to find (max 1000 chars; bounds regex-mode pattern size)."),
+  replace: z16.string().describe("Replacement text. Supports $1, $2, \u2026 backreferences in regex mode."),
+  regex: z16.boolean().default(false).describe("Treat find as a regular expression."),
+  caseSensitive: z16.boolean().default(false).describe("Case-sensitive matching."),
+  wholeWord: z16.boolean().default(false).describe("Match whole words only (\\b word-boundary)."),
+  limit: z16.number().int().min(1).optional().describe("Maximum number of replacements. Omit to replace all."),
+  dryRun: z16.boolean().default(false).describe("If true, report matches without writing anything.")
 });
 function escapeRegex(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -1048,7 +1254,7 @@ async function replaceInNote(ctx2, input) {
   const body = raw.slice(fm.bodyStart);
   const allMatches = [...body.matchAll(re)];
   const toReplace = input.limit !== void 0 ? allMatches.slice(0, input.limit) : allMatches;
-  const matches = toReplace.map((m) => {
+  const matches2 = toReplace.map((m) => {
     const fileOffset = fm.bodyStart + (m.index ?? 0);
     const line = raw.slice(0, fileOffset).split("\n").length;
     return { line, byteOffset: fileOffset };
@@ -1057,7 +1263,7 @@ async function replaceInNote(ctx2, input) {
     return {
       path: input.path,
       replacements: toReplace.length,
-      matches,
+      matches: matches2,
       frontmatterUnchanged: true
     };
   }
@@ -1086,88 +1292,12 @@ async function replaceInNote(ctx2, input) {
   return {
     path: input.path,
     replacements: toReplace.length,
-    matches,
+    matches: matches2,
     bytesWritten: Buffer.byteLength(newContent, "utf8"),
     frontmatterUnchanged: true
   };
 }
 
-// src/tools/search.ts
-import { z as z15 } from "zod";
-
-// src/index/excerpt.ts
-function extractExcerpt(text, terms, maxLen = 200) {
-  const lower = text.toLowerCase();
-  let bestIdx = -1;
-  for (const term of terms) {
-    const idx = lower.indexOf(term.toLowerCase());
-    if (idx !== -1 && (bestIdx === -1 || idx < bestIdx)) {
-      bestIdx = idx;
-    }
-  }
-  if (bestIdx === -1) {
-    return truncate(text.trimStart(), maxLen);
-  }
-  const half = Math.floor(maxLen / 2);
-  const start = Math.max(0, bestIdx - half);
-  const end = Math.min(text.length, bestIdx + half + (terms[0]?.length ?? 0));
-  const slice = text.slice(start, end).trim();
-  return `${start > 0 ? "\u2026" : ""}${slice}${end < text.length ? "\u2026" : ""}`;
-}
-function truncate(s, max) {
-  if (s.length <= max) return s;
-  return `${s.slice(0, max).trimEnd()}\u2026`;
-}
-
-// src/tools/search.ts
-var SearchInput = z15.object({
-  query: z15.string().min(1).describe("Search query. Supports fuzzy matching and prefix search."),
-  limit: z15.number().int().min(1).max(50).default(10).describe("Maximum number of results to return."),
-  folder: z15.string().optional().describe("Restrict results to notes under this vault-relative folder prefix."),
-  tag: z15.string().optional().describe("Restrict results to notes containing this tag."),
-  excerptLength: z15.number().int().min(20).max(2e3).optional().describe(
-    "Max characters of match context per hit (default 120). Lower trims payload; higher gives more context."
-  )
-});
-function basenameNoExt(path2) {
-  const base = path2.slice(path2.lastIndexOf("/") + 1);
-  const dot = base.lastIndexOf(".");
-  return dot > 0 ? base.slice(0, dot) : base;
-}
-function search(ctx2, input) {
-  const results = ctx2.index.search(input.query, {
-    boost: { title: 3, tags: 2, body: 1 },
-    fuzzy: 0.2,
-    prefix: true
-  });
-  const terms = input.query.toLowerCase().split(/\s+/).filter((t) => t.length > 1);
-  const hits = [];
-  for (const r of results) {
-    if (input.folder && !r.id.startsWith(input.folder)) continue;
-    if (input.tag) {
-      const note2 = ctx2.notes.get(r.id);
-      if (!note2) continue;
-      const noteTags2 = note2.tags.split(" ");
-      if (!noteTags2.some((t) => t === input.tag || t === input.tag?.replace(/^#/, ""))) continue;
-    }
-    const note = ctx2.notes.get(r.id);
-    const body = note?.body ?? "";
-    const noteTags = note?.tags ? note.tags.split(" ").filter(Boolean) : [];
-    const title = r.title;
-    const hit = {
-      path: r.id,
-      // Round the raw MiniSearch score: 2 decimals preserve relevance gaps without 17-digit float tax.
-      score: Math.round(r.score * 100) / 100,
-      excerpt: extractExcerpt(body, terms, input.excerptLength ?? 120)
-    };
-    if (title && title !== basenameNoExt(r.id)) hit.title = title;
-    if (noteTags.length > 0) hit.tags = noteTags;
-    hits.push(hit);
-    if (hits.length >= input.limit) break;
-  }
-  return hits;
-}
-
 // src/dispatch.ts
 var META_KEYS = [
   "path",
@@ -1180,6 +1310,12 @@ var META_KEYS = [
   "pattern",
   "minCount",
   "sort",
+  "order",
+  "select",
+  "modifiedAfter",
+  "modifiedBefore",
+  "minSizeBytes",
+  "maxSizeBytes",
   "period",
   "date"
 ];
@@ -1191,6 +1327,7 @@ function safeMeta(args) {
     if (a[k] !== void 0) out[k] = a[k];
   }
   if (typeof a.query === "string") out.queryLen = a.query.length;
+  if (Array.isArray(a.where)) out.whereCount = a.where.length;
   return out;
 }
 function resultBytes(r) {
@@ -1227,6 +1364,11 @@ async function run(ctx2, name, args) {
       const hits = search(ctx2, input);
       return { content: [{ type: "text", text: JSON.stringify(hits) }] };
     }
+    case "query_notes": {
+      const input = QueryNotesInput.parse(args);
+      const hits = queryNotes(ctx2, input);
+      return { content: [{ type: "text", text: JSON.stringify(hits) }] };
+    }
     case "read_note": {
       const input = ReadNoteInput.parse(args);
       const result = await readNote(ctx2, input);
@@ -1351,7 +1493,7 @@ function classify(relPath) {
   return "other";
 }
 async function walkVault(vaultRoot2) {
-  const matches = await fg("**/*", {
+  const matches2 = await fg("**/*", {
     cwd: vaultRoot2,
     absolute: true,
     onlyFiles: true,
@@ -1363,7 +1505,7 @@ async function walkVault(vaultRoot2) {
     suppressErrors: true
   });
   const entries = [];
-  for (const m of matches) {
+  for (const m of matches2) {
     const absPath = typeof m === "string" ? m : m.path;
     const stats = typeof m === "string" ? await stat(absPath) : m.stats;
     if (!stats) continue;
@@ -1415,6 +1557,7 @@ async function buildIndex(vaultRoot2) {
           body: fm.body,
           tags: allTags.join(" "),
           fmKeys: fm.keys.join(" "),
+          fm: fm.data,
           raw,
           sizeBytes: entry.sizeBytes,
           mtimeMs: entry.mtimeMs
@@ -1465,7 +1608,7 @@ function parseInitArgs(argv) {
     else if (a === "--vault") opts.vault = argv[++i];
     else if (a === "--client") {
       const v = argv[++i];
-      if (v === "desktop" || v === "code") opts.client = v;
+      if (v === "desktop" || v === "code" || v === "cursor") opts.client = v;
     }
   }
   return opts;
@@ -1493,6 +1636,10 @@ function claudeDesktopConfigPath(platform, env) {
   }
   return j(home, ".config", "Claude", "claude_desktop_config.json");
 }
+function cursorConfigPath(platform, env) {
+  const j = platform === "win32" ? path.win32.join : path.posix.join;
+  return j(env.home ?? "", ".cursor", "mcp.json");
+}
 function obsidianRegistryPath(platform, env) {
   if (platform === "win32") {
     const j2 = path.win32.join;
@@ -1662,7 +1809,8 @@ async function runInit(opts, deps) {
     out.push("Add to Claude Code by running:", "", `  ${mcpAddCommand(vaultPath)}`, "");
     return { ok: true, exitCode: 0, output: out };
   }
-  const configPath = claudeDesktopConfigPath(deps.platform, {
+  const clientLabel = opts.client === "cursor" ? "Cursor" : "Claude Desktop";
+  const configPath = opts.client === "cursor" ? cursorConfigPath(deps.platform, { home: deps.env.HOME }) : claudeDesktopConfigPath(deps.platform, {
     home: deps.env.HOME,
     appData: deps.env.APPDATA
   });
@@ -1673,12 +1821,12 @@ async function runInit(opts, deps) {
   );
   if (!opts.write) {
     out.push(
-      "Add this to your Claude Desktop config:",
+      `Add this to your ${clientLabel} config:`,
       `  ${configPath}`,
       "",
       block,
       "",
-      "Then restart Claude Desktop. Or re-run with --write to patch it automatically."
+      `Then restart ${clientLabel}. Or re-run with --write to patch it automatically.`
     );
     return { ok: true, exitCode: 0, output: out };
   }
@@ -1713,7 +1861,7 @@ async function runInit(opts, deps) {
     `\u2713 Patched ${configPath}`,
     backupPath ? `  Backup saved to ${backupPath}` : "  (created a new config file)",
     "",
-    "Restart Claude Desktop to load seekstone."
+    `Restart ${clientLabel} to load seekstone.`
   );
   return { ok: true, exitCode: 0, output: out, wrotePath: configPath, backupPath };
 }
@@ -1928,7 +2076,7 @@ function startWatcher(ctx2, log2, opts) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.7.1" : "0.0.0-dev";
+var VERSION = true ? "0.8.0" : "0.0.0-dev";
 var intent = parseCliIntent(process.argv.slice(2));
 if (intent === "version") {
   process.stdout.write(`${VERSION}
@@ -1980,6 +2128,63 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["query"]
       }
     },
+    {
+      name: "query_notes",
+      description: "Structured metadata query \u2014 filter notes by frontmatter key/value predicates, tag, folder, modified time, and size. Returns compact rows (path + title by default; opt into more via select), not note content. Use this instead of search when filtering by properties rather than text.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          where: {
+            type: "array",
+            description: "Frontmatter predicates \u2014 all must match (AND).",
+            items: {
+              type: "object",
+              properties: {
+                key: { type: "string", description: "Frontmatter key to test." },
+                op: {
+                  type: "string",
+                  enum: ["eq", "ne", "contains", "exists", "missing", "gt", "gte", "lt", "lte"],
+                  description: "eq/ne compare scalars; contains matches array membership or substring; exists/missing test key presence; gt/gte/lt/lte compare numbers or strings (ISO dates sort correctly)."
+                },
+                value: {
+                  description: "Comparison value. Required for every op except exists/missing."
+                }
+              },
+              required: ["key", "op"]
+            }
+          },
+          folder: { type: "string", description: "Restrict to a vault-relative folder prefix." },
+          tag: { type: "string", description: "Restrict to notes with this tag (# optional)." },
+          modifiedAfter: {
+            type: "string",
+            description: "Only notes modified at or after this ISO 8601 date/time."
+          },
+          modifiedBefore: {
+            type: "string",
+            description: "Only notes modified before this ISO 8601 date/time."
+          },
+          minSizeBytes: { type: "number", description: "Only notes at least this many bytes." },
+          maxSizeBytes: { type: "number", description: "Only notes at most this many bytes." },
+          select: {
+            type: "array",
+            items: { type: "string" },
+            description: 'Extra fields per hit: frontmatter keys, or "mtime", "size", "tags". Default returns only path + title.'
+          },
+          sort: {
+            type: "string",
+            enum: ["path", "title", "mtime", "size"],
+            description: "Sort field (default path)."
+          },
+          order: {
+            type: "string",
+            enum: ["asc", "desc"],
+            description: "Sort order (default asc)."
+          },
+          limit: { type: "number", description: "Max results (1\u2013500, default 100)." }
+        },
+        required: []
+      }
+    },
     {
       name: "read_note",
       description: "Read a note or a span of it \u2014 by heading section, block reference, or line range. Returns structured JSON with the content, bytes returned, and total note size so payload savings are measurable. Use search or outline_note first to find the right path and section names.",
@@ -2301,7 +2506,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 var transport = new StdioServerTransport();
 await server.connect(transport);
-log.info("ready", { tools: 16, transport: "stdio" });
+log.info("ready", { tools: 17, transport: "stdio" });
 process.stderr.write(
   `seekstone: add to Claude Desktop:
 ${JSON.stringify(