# Mcpvault (MCP server)

> Mcpvault is an MCP server that lets compatible clients read, search, and edit notes in an Obsidian vault. MCPVault works directly with vault files, restricts file operations to the configured vault root, and preserves formatting for unchanged frontmatter fields. It has 1,703 GitHub stars, is released under the MIT license and runs locally with npx -y @bitbonsai/mcpvault.

A local MCP server that lets compatible clients read, search, and edit notes in an Obsidian vault. MCPVault works directly with vault files, restricts file operations to the configured vault root, and preserves formatting for unchanged frontmatter fields.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/bitbonsai/mcpvault |
| GitHub stars | 1,703 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @bitbonsai/mcpvault |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Productivity |
| Latest release | v0.17.0 (Oct 22, 2026) |
| Last commit | Oct 23, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcpvault": {
      "command": "npx",
      "args": [
        "-y",
        "@bitbonsai/mcpvault"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio mcpvault -- npx -y @bitbonsai/mcpvault
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcpvault": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bitbonsai/mcpvault"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcpvault": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bitbonsai/mcpvault"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Similar MCP servers

- [IWE (iwe.md)](https://appsgit.com/mcp-servers/iwe-iwe-md): Markdown knowledge base as agent memory. Runs against the notes directory it is started in. (1,795 stars, Apache-2.0)
- [Minutes](https://appsgit.com/mcp-servers/minutes): The private, owned conversation-memory layer for AI. (1,571 stars, MIT)
- [llmwiki](https://appsgit.com/mcp-servers/llmwiki): Compile documents into a cited knowledge wiki. (2,215 stars, MIT)
- [Keeper.sh](https://appsgit.com/mcp-servers/keeper-sh): Calendar sync tool & universal calendar MCP server. (1,421 stars, AGPL-3.0)
- [Google Workspace MCP](https://appsgit.com/mcp-servers/google-workspace-mcp): Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace MCP Server & CLI Tool. (3,414 stars, MIT)
- [Nx MCP](https://appsgit.com/mcp-servers/nx-mcp): A Model Context Protocol server implementation for Nx. (1,413 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/mcpvault
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.