Obsidian wiki MCP

MCP server implementing Karpathy's LLM Wiki pattern for Obsidian vaults.

Solves document drift — your vault stays up-to-date as knowledge evolves across AI sessions.

fluid not opinionated   — bring your own folder structure
storage not intelligence — the server stores; the LLM decides
always searchable        — BM25 index rebuilt on every write

Design principle: The server is a pure storage/retrieval layer. All content decisions (what to write, how to synthesize) are made by the host LLM (Claude). The server never calls an AI model.

Quick Start

1. Add to your AI client:

Claude Code

claude mcp add obsidian-wiki -- npx -y obsidian-wiki-mcp --vault "/path/to/your/vault"

Kiro CLI

kiro mcp add obsidian-wiki -- npx -y obsidian-wiki-mcp --vault "/path/to/your/vault"

OpenAI Codex CLI

codex --mcp-config '{"obsidian-wiki":{"command":"npx","args":["-y","obsidian-wiki-mcp","--vault","/path/to/your/vault"]}}'

Paths with spaces must be quoted. See Configuration for all installation options.

2. Initialize the vault:

Call wiki_init() to initialize the vault.

3. Start using:

Ingest this session into the wiki: [paste content]
Use wiki_query to find information about [topic]

Related MCP server: Personal Notes Assistant

Documentation

Recent tool contract update:

• wiki_write_page and wiki_apply_fix now include a diff field (unified diff) in write responses where applicable.

• See Tools Reference for exact behavior by tool/action.

License

MIT