kaphera-vault-mcp

MCP server that gives your Claude (Code, Cowork, Desktop) read access to the private Kaphera knowledge vault — markdown notes plus a prebuilt knowledge graph.

Install

Add this to your Claude MCP config:

{
  "kaphera-vault": {
    "command": "npx",
    "args": ["-y", "kaphera-vault-mcp"],
    "env": {
      "KAPHERA_VAULT_TOKEN": "ghp_your_personal_access_token_here"
    }
  }
}

Restart Claude. The server will clone the vault on first launch (to ~/.kaphera-vault/repo) and git pull on every subsequent start.

Getting a token

You need a GitHub PAT with read access to the private kaphera-vault repo.

1. Ask Amin to invite you to the repo (or to share a deploy token).
2. github.com → Settings → Developer settings → Fine-grained tokens → Generate.
3. Scope: only abougsea/kaphera-vault, Contents: Read-only.
4. Paste the ghp_… value into the KAPHERA_VAULT_TOKEN env above.

The token lives only in your local MCP config. The npm package itself contains no credentials.

Tools exposed

| Tool | What it does | |-|-| | search_vault | Full-text search across all markdown | | read_note | Read a single note by repo-relative path | | list_notes | List markdown files, optionally by prefix | | get_node | Graph: fetch a node by id | | get_neighbors | Graph: nodes connected to a given node | | god_nodes | Graph: most-connected concepts in the vault | | graph_stats | Graph: counts + repo metadata |

Env vars

| Var | Default | Purpose | |-|-|-| | KAPHERA_VAULT_TOKEN | (required) | GitHub PAT | | KAPHERA_VAULT_REPO | abougsea/kaphera-vault | Source repo | | KAPHERA_VAULT_BRANCH | main | Branch to track | | KAPHERA_VAULT_DIR | ~/.kaphera-vault/repo | Local cache path |

Updating

The MCP runs git pull every time Claude starts. To force a fresh state, delete ~/.kaphera-vault/repo and restart Claude.