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]

---

Documentation

Doc	Description
Getting Started	First-time setup, existing vault migration, CLAUDE.md / AGENTS.md
Vault Structure	Folder layout, page format, tags, naming convention
Tools Reference	All MCP tools with parameters and examples
Workflows	Common usage patterns
Configuration	Claude Code setup, server config file
Troubleshooting	Common issues and fixes

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