# seekstone

Connects an AI client to Obsidian files for searching and editing. The Obsidian app can stay closed while seekstone works with the vault.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 34
- Author: shaqmughal
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shaqmughal/seekstone
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/seekstone

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SEEKSTONE_VAULT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add seekstone -e SEEKSTONE_VAULT=<SEEKSTONE_VAULT> -- npx -y seekstone
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add seekstone --env SEEKSTONE_VAULT=<SEEKSTONE_VAULT> -- npx -y seekstone
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "seekstone": {
            "command": "npx",
            "args": [
                "-y",
                "seekstone"
            ],
            "env": {
                "SEEKSTONE_VAULT": "<SEEKSTONE_VAULT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "seekstone": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "seekstone"
            ],
            "env": {
                "SEEKSTONE_VAULT": "<SEEKSTONE_VAULT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SEEKSTONE_VAULT=<SEEKSTONE_VAULT> seekstone npx -y seekstone
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md