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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
543e75893505a49487a7836015735ec0c059199e5aaf153964ade08be94562ff
|
|
| MD5 |
7531fdcb890dbc7b6694d6311b25cc47
|
|
| BLAKE2b-256 |
e2023532f914b66bd46c4b459635943e9f52c32a1c757d221d4a4520b831a3f3
|
Provenance
The following attestation bundles were made for vault_bridge-1.0.4.tar.gz:
Publisher:
ci.yml on Airgap-fleet/vault-bridge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vault_bridge-1.0.4.tar.gz -
Subject digest:
543e75893505a49487a7836015735ec0c059199e5aaf153964ade08be94562ff - Sigstore transparency entry: 2682492711
- Sigstore integration time:
-
Permalink:
Airgap-fleet/vault-bridge@1010641eccd61d8b29c2b566e9505fa747da7ad0 -
Branch / Tag:
refs/tags/v1.0.4 - Owner: https://github.com/Airgap-fleet
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@1010641eccd61d8b29c2b566e9505fa747da7ad0 -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7a10a610aa750616bf0afb95f20350702b9cf3ad3ab9065db5c74ad3f532ec86
|
|
| MD5 |
5dc0471346264de90b476c5e654eb285
|
|
| BLAKE2b-256 |
17851afcce140d29486427d35458b0df7eb95c922d8f5eb7666b81b100b23c27
|
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
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vault_bridge-1.0.4-py3-none-any.whl -
Subject digest:
7a10a610aa750616bf0afb95f20350702b9cf3ad3ab9065db5c74ad3f532ec86 - Sigstore transparency entry: 2682492760
- Sigstore integration time:
-
Permalink:
Airgap-fleet/vault-bridge@1010641eccd61d8b29c2b566e9505fa747da7ad0 -
Branch / Tag:
refs/tags/v1.0.4 - Owner: https://github.com/Airgap-fleet
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@1010641eccd61d8b29c2b566e9505fa747da7ad0 -
Trigger Event:
push
-
Statement type: