seekstone — Claude Code MCP server for Obsidian search
Connects an AI client to Obsidian files for searching and editing. The Obsidian app can stay closed while seekstone works with the vault.
claude mcp add seekstone -e SEEKSTONE_VAULT=<SEEKSTONE_VAULT> -- npx -y seekstoneWhat seekstone does
seekstone accesses an Obsidian vault directly on disk and gives an AI client read and write access. It works without an Obsidian plugin or an open Obsidian app. The server includes 25 tools, with full-text search that supports fuzzy matches and word prefixes.
An optional semantic mode uses a small embedding model on the device and works offline. The query_notes tool filters notes by properties, dates, and size. Installation through npx requires Node.js 22 or newer. Set SEEKSTONE_VAULT to the vault path; the server needs that location to read your notes.
What it helps with
- find a note by keywords or a word fragment
- filter notes by properties and dates
- search notes by meaning with a local model
- edit a file in an Obsidian vault
Example prompts for the agent
- Search my Obsidian vault for notes about MCP setup.
- Find notes whose dates fall within this period.
- Update the release plan note and save the changes to my vault.
How to install seekstone
Platform CLI
claude mcp add seekstone -e SEEKSTONE_VAULT=<SEEKSTONE_VAULT> -- npx -y seekstoneReplace <…> with your own values
Platform CLI
codex mcp add seekstone --env SEEKSTONE_VAULT=<SEEKSTONE_VAULT> -- npx -y seekstoneReplace <…> with your own values
Config file
{
"mcpServers": {
"seekstone": {
"command": "npx",
"args": [
"-y",
"seekstone"
],
"env": {
"SEEKSTONE_VAULT": "<SEEKSTONE_VAULT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"seekstone": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"seekstone"
],
"env": {
"SEEKSTONE_VAULT": "<SEEKSTONE_VAULT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e SEEKSTONE_VAULT=<SEEKSTONE_VAULT> seekstone npx -y seekstoneReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about seekstone
How do I install seekstone in Claude Code?
Run claude mcp add seekstone -e SEEKSTONE_VAULT=<SEEKSTONE_VAULT> -- npx -y seekstone. Replace <SEEKSTONE_VAULT> with the path to your Obsidian vault.
What does seekstone do?
It lets an AI client search and edit Obsidian files directly on disk. Obsidian itself does not need to be running.
Does seekstone require a local model?
No. Semantic search with an on-device embedding model is optional; the server also offers other search modes.
