Query, search, and manipulate Obsidian vaults programmatically with 35 tools covering notes, graph analysis, tags, and canvas operations. For developers building automation, AI agents, or integrations on top of Obsidian knowledge bases.
io.github.afable702/vault-mcp-tools
Local install
STDIO
1 required env var
How models use it and what it is built for.
Query, search, and manipulate Obsidian vaults programmatically with 35 tools covering notes, graph analysis, tags, and canvas operations. For developers building automation, AI agents, or integrations on top of Obsidian knowledge bases.
Local install — runs as a subprocess.
Configuration this server reads at startup.
Absolute path to the Obsidian vault root directory
Bearer token for the Obsidian REST API (enables 3 bonus tools: execute_command, list_commands, open_in_obsidian)
REST API port (default: 27124)
Transport mode: stdio (default) or http
HTTP transport port (default: 3000)
Bearer token for HTTP transport authentication
Where to find authoritative docs and source for Afable702 Vault MCP Tools.
Paste any of these into Agent Studio after connecting Afable702 Vault MCP Tools.
Common questions about connecting and running Afable702 Vault MCP Tools.
What do I need to set up vault-mcp-tools?
Set the required OBSIDIAN_VAULT_PATH environment variable to your vault's root directory. Optionally, configure OBSIDIAN_REST_TOKEN and OBSIDIAN_REST_PORT to unlock three additional tools (execute_command, list_commands, open_file) via Obsidian's REST API.
Can I use this server over HTTP instead of stdio?
Yes. Set OBSIDIAN_TRANSPORT=http and configure OBSIDIAN_HTTP_PORT (default 3000) and OBSIDIAN_HTTP_AUTH_TOKEN for authentication. The default transport is stdio.
What are the 35 tools this server provides?
The registry lists coverage for notes, search, graph analysis, tags, and canvas operations. Refer to the server's tool documentation or call list_tools to see the complete inventory and their schemas.
Do I need an Obsidian REST API token?
No—the token is optional. Without it, you get the core 32 tools for vault querying and manipulation. With OBSIDIAN_REST_TOKEN set, you unlock 3 bonus tools that execute Obsidian commands and open files directly.
Can this server modify notes in my vault?
Yes. The server includes tools for creating and manipulating notes. Always test on a vault backup first, and ensure OBSIDIAN_VAULT_PATH points to the correct directory to avoid accidental changes.
MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 30+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.
Open Agent Studio