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.4.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.4-py3-none-any.whl (18.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: vault_bridge-1.0.4.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.4.tar.gz
Algorithm Hash digest
SHA256 543e75893505a49487a7836015735ec0c059199e5aaf153964ade08be94562ff
MD5 7531fdcb890dbc7b6694d6311b25cc47
BLAKE2b-256 e2023532f914b66bd46c4b459635943e9f52c32a1c757d221d4a4520b831a3f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for vault_bridge-1.0.4.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.4-py3-none-any.whl.

File metadata

  • Download URL: vault_bridge-1.0.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 7a10a610aa750616bf0afb95f20350702b9cf3ad3ab9065db5c74ad3f532ec86
MD5 5dc0471346264de90b476c5e654eb285
BLAKE2b-256 17851afcce140d29486427d35458b0df7eb95c922d8f5eb7666b81b100b23c27

See more details on using hashes here.

Provenance

The following attestation bundles were made for vault_bridge-1.0.4-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

This release

1.0.4 This release

2 files

1.0.3

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