# vault-knowledge

This MCP server reads an Obsidian knowledge graph to search concepts, retrieve articles, and surface contradictions between notes.

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

## What it does

vault-knowledge gives MCP clients read-only access to an Obsidian vault’s knowledge graph. Its tools search for concepts and connections, find active contradictions, and return an article with its frontmatter, body, and resolved wikilinks. Use it to check what your notes say before relying on them in an agent workflow.

The server requires Node 22.5 or later. The first concept search downloads the nomic-embed-text-v1.5 model. Access is limited to files under `knowledge/{concepts,connections,qa}` and set in the configuration rather than passed in a client request. That boundary matters: a request cannot grant the server access to other vault folders.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add vault-knowledge -- npx -y @swins/vault-knowledge-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add vault-knowledge -- npx -y @swins/vault-knowledge-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vault-knowledge": {
            "command": "npx",
            "args": [
                "-y",
                "@swins/vault-knowledge-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vault-knowledge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@swins/vault-knowledge-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add vault-knowledge npx -y @swins/vault-knowledge-mcp
```

## When to use it
- search an Obsidian knowledge base for concepts and connections
- spot active contradictions in the reasoning graph
- retrieve an article with its metadata and linked notes

## Example prompts
- Search my knowledge base for concepts related to API design.
- Find active contradictions in the vault.
- Fetch the article with slug `slug`, including its links.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
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