Select Active Vault
vault.selectSet the active vault for subsequent filesystem operations by id, name, or path, ensuring file tools target the correct Obsidian vault.
Instructions
Set the session-active vault for subsequent filesystem tool calls. Identify the target by EXACTLY ONE of id (stable id from vault.list), name (case-insensitive match), or path (absolute directory path — need not appear in vault.list; lets the LLM point at a fresh/empty vault to initialise). Precedence chain becomes: per-call vaultPath argument (highest) → this session selection → OBSIDIAN_VAULT_PATH → error. Explicit vaultPath arguments on individual tool calls always override this selection. Respects KOBSIDIAN_VAULT_ALLOW / KOBSIDIAN_VAULT_DENY operator gating (though OBSIDIAN_VAULT_PATH is never filtered). Does NOT change which vault the live Obsidian process has open — workspace.* and commands.* tools remain tied to OBSIDIAN_API_URL. HTTP deployments: this server shares the selection across HTTP clients, so concurrent multi-client HTTP setups should pass vaultPath per call instead.
Examples:
Example 1 — Switch to the vault named 'Work':
{
"name": "Work"
}Example 2 — Select by id from vault.list:
{
"id": "58f115bd2c2febd2"
}Example 3 — Point at an ad-hoc path (e.g. a fresh vault to initialise):
{
"path": "/Users/alice/FreshVault"
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Vault id returned by `vault.list`. Mutually exclusive with `name` and `path`. | |
| name | No | Case-insensitive vault name match against `vault.list`. Mutually exclusive with `id` and `path`. | |
| path | No | Absolute vault directory path. Need not appear in `vault.list` — accepting an ad-hoc path lets the LLM point at a fresh vault. Must exist and be a directory. Mutually exclusive with `id` and `name`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| active | Yes | A single vault entry returned by `vault.list` and `vault.current.active`. | |
| target | Yes | ||
| changed | Yes | ||
| summary | Yes | ||
| previous | Yes | The previously-selected vault, or null if none was selected. |