# bitbonsai/mcpvault

A lightweight Model Context Protocol (MCP) server for safe Obsidian vault access

Repository: https://github.com/bitbonsai/mcpvault
Canonical: https://ross.abutalabs.com/products/mcpvault
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-08-26T13:19:11+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 24
- inputs: {"age_days": 346, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1637, forks 123 (observed 2026-08-28T04:05:14.949123+00:00)

## What it is
MCPVault is a lightweight Model Context Protocol (MCP) server that gives AI clients safe read, search, and edit access to an Obsidian vault. It operates directly on vault files, restricts operations to the configured vault root, and preserves frontmatter formatting.

## Use cases
- let Claude Desktop read and edit my Obsidian notes
- search my Obsidian vault from an AI assistant
- connect ChatGPT or Cursor to my local markdown notes
- give an MCP client sandboxed access to a notes folder
- query and update note frontmatter via AI

## When to choose
- you use Obsidian and want AI clients to access your vault locally
- you need a simple stdio MCP server with vault-root sandboxing
- you want formatting-safe edits to markdown frontmatter

## When to avoid
- you need a hosted or multi-user notes sync service
- your notes are not in Obsidian/markdown format
- you need a full Obsidian plugin with UI integration

## Facets
- artifact type: service
- maturity: active
- function: mcp, search-engine, file-system
- domain: developer-tools, large-language-models
- platform: cli, cross-platform
- tags: mcp-server, obsidian, note-taking, knowledge-management, markdown, vault-access, ai-agents, nodejs

## Member repositories
- bitbonsai/mcpvault (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:14.949123+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:46:40.881140+00:00, confidence not recorded.
  - readme: https://github.com/bitbonsai/mcpvault (fetched 2026-08-28T04:05:14.949123+00:00, sha 16c9b3ae68c4)
- Data as of 2026-08-30T08:39:29.467469+00:00.