Skip to main content

Vault Bridge

Bridge your AI assistant to local knowledge vaults — read, write, search, and manage notes without cloud dependencies.

Features

  • read_note — Read a note with optional frontmatter parsing
  • write_note — Write notes with YAML frontmatter support
  • list_notes — List notes with glob filtering and recursion
  • search_notes — Regex search across vault content
  • search_frontmatter — Query notes by frontmatter key/value
  • get_daily_note — Get or create daily notes with templates

Installation

pip install vault-bridge

Usage

vault-bridge

Or configure in your MCP client:

{
  "mcpServers": {
    "vault": {
      "command": "vault-bridge",
      "env": {
        "VAULT_BRIDGE_VAULT_PATH": "C:/path/to/vault"
      }
    }
  }
}

Configuration

Environment Variable Default Description
VAULT_BRIDGE_VAULT_PATH Current directory Path to vault root
VAULT_BRIDGE_MAX_FILE_SIZE 10MB Max file size for operations
VAULT_BRIDGE_DEFAULT_ENCODING utf-8 Text encoding
VAULT_BRIDGE_INDEX_FRONTMATTER true Parse YAML frontmatter
VAULT_BRIDGE_FOLLOW_SYMLINKS false Follow symlinks

Tool Reference

read_note

{
  "path": "Projects/roadmap.md",
  "include_frontmatter": true
}

write_note

{
  "path": "Projects/new-idea.md",
  "content": "# New Idea\n\nDetails here...",
  "frontmatter": { "tags": ["idea", "draft"], "status": "wip" }
}

list_notes

{
  "path": "Projects",
  "glob_pattern": "**/*.md",
  "recursive": true
}

search_notes

{
  "pattern": "MCP",
  "path": ".",
  "max_results": 50
}

search_frontmatter

{
  "key": "status",
  "value": "done",
  "operator": "eq"
}

get_daily_note

{
  "date": "2026-08-21",
  "folder": "Daily Notes",
  "create_if_missing": true
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vault_bridge-1.0.3.tar.gz (22.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vault_bridge-1.0.3-py3-none-any.whl (18.1 kB view details)

Uploaded Python 3

File details

Details for the file vault_bridge-1.0.3.tar.gz.

File metadata

  • Download URL: vault_bridge-1.0.3.tar.gz
  • Upload date:
  • Size: 22.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vault_bridge-1.0.3.tar.gz
Algorithm Hash digest
SHA256 ff57ec28fd44289ba0852cf7a073cbf425041a3ff3ba5604138eb32928cb6451
MD5 9395a153623e7372513d01a9b93311cd
BLAKE2b-256 b42571e310f09d4583746ec54d1cc4e581e6b9a148cccf61d18ff8deaeca7061

See more details on using hashes here.

Provenance

The following attestation bundles were made for vault_bridge-1.0.3.tar.gz:

Publisher: ci.yml on Airgap-fleet/vault-bridge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vault_bridge-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: vault_bridge-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 18.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vault_bridge-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 edb1843a4658d1ae3a2ebfe55776431114f1bcd045f3b6bce46e056c3dc5db49
MD5 8cc121202dae1256cfb90e947138e008
BLAKE2b-256 d95849ff86b9ebab0a8e7d17878bbeff2754201d66cd856a79a772264fe5f2f8

See more details on using hashes here.

Provenance

The following attestation bundles were made for vault_bridge-1.0.3-py3-none-any.whl:

Publisher: ci.yml on Airgap-fleet/vault-bridge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.0.4

2 files

This release

1.0.3 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page