Seekstone

What shaqmughal/seekstone does

shaqmughal/seekstone exposes an Obsidian vault through MCP while reading the vault directly from its filesystem. Obsidian does not need to be running, and the Local REST API plugin is not required. The server is intended for MCP clients that need to search, inspect, organize, or edit Markdown notes without sending vault data to an external service.

Search returns ranked excerpts rather than complete notes, with an excerpt length of about 120 characters by default. Full-text search supports fuzzy and prefix matching. An optional semantic mode uses a local embedding model; hybrid mode combines meaning-based and keyword search. The model is downloaded once and runs locally afterward.

How it works

Install the npm package with npx -y seekstone and point SEEKSTONE_VAULT at the vault's absolute path. Seekstone maintains an in-process index for keyword search and reads note files directly. Queries can be scoped by folders or tags and can impose byte budgets, so broad searches and multi-note reads return bounded results.

context_pack combines ranked excerpts, linked neighbor notes, short summaries, and follow-up paths for a question-oriented response. For more controlled workflows, an agent can resolve a note path, inspect its outline, read a section or block, and then follow backlinks or outgoing links.

Setup and configuration

Run the package through a standard MCP stdio configuration:

{
  "command": "npx",
  "args": ["-y", "seekstone"],
  "env": {
    "SEEKSTONE_VAULT": "/absolute/path/to/your/vault"
  }
}

Node.js 22.22 or newer is required. Set SEEKSTONE_SEMANTIC=1 to enable semantic and hybrid search. Semantic search uses a local embedding model and requires a one-time download of approximately 30 MB. The package also has an older obsidian-mcp-seekstone npm name, while seekstone is the primary command.

Tools and capabilities

• Search notes with ranked excerpts, fuzzy matching, prefix matching, and optional semantic modes.
• Query frontmatter, tags, folders, modification times, and file sizes with comparison predicates and selectable fields.
• Read one note or batches of up to 20 notes, with section, block, line-range, and total-byte controls.
• Navigate with note outlines, aliases, canonical path resolution, backlinks, outgoing links, tags, and periodic notes.
• List Markdown tasks with filters and custom checkbox states, then update one task with a text guard.
• Create, append, patch, replace, move, rename, and delete notes; link references are rewritten for supported moves and heading renames.
• Review journaled writes and undo a write back to the byte-identical previous state, including multi-file operations.

Limitations and notes

Search and context tools are designed to return compact results; use read_note or read_notes when complete content is needed. Batch reads are capped at 20 notes and a default total budget of 16 KB, while context_pack defaults to 2 KB. Deletes move notes to the vault's .trash/ folder unless permanent deletion is requested. The server supports macOS, Linux, and Windows.