Complete Obsidian vault MCP server. 35 tools: notes, search, graph, tags, canvas.
Connect Runs on your machine
claude mcp add vault-mcp-tools -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -e OBSIDIAN_REST_TOKEN=<OBSIDIAN_REST_TOKEN> -e OBSIDIAN_REST_PORT=<OBSIDIAN_REST_PORT> -e OBSIDIAN_TRANSPORT=<OBSIDIAN_TRANSPORT> -e OBSIDIAN_HTTP_PORT=<OBSIDIAN_HTTP_PORT> -e OBSIDIAN_HTTP_AUTH_TOKEN=<OBSIDIAN_HTTP_AUTH_TOKEN> -- npx -y [email protected]{
"mcpServers": {
"vault-mcp-tools": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
"OBSIDIAN_REST_TOKEN": "<OBSIDIAN_REST_TOKEN>",
"OBSIDIAN_REST_PORT": "<OBSIDIAN_REST_PORT>",
"OBSIDIAN_TRANSPORT": "<OBSIDIAN_TRANSPORT>",
"OBSIDIAN_HTTP_PORT": "<OBSIDIAN_HTTP_PORT>",
"OBSIDIAN_HTTP_AUTH_TOKEN": "<OBSIDIAN_HTTP_AUTH_TOKEN>"
}
}
}
}{
"mcpServers": {
"vault-mcp-tools": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
"OBSIDIAN_REST_TOKEN": "<OBSIDIAN_REST_TOKEN>",
"OBSIDIAN_REST_PORT": "<OBSIDIAN_REST_PORT>",
"OBSIDIAN_TRANSPORT": "<OBSIDIAN_TRANSPORT>",
"OBSIDIAN_HTTP_PORT": "<OBSIDIAN_HTTP_PORT>",
"OBSIDIAN_HTTP_AUTH_TOKEN": "<OBSIDIAN_HTTP_AUTH_TOKEN>"
}
}
}
}{
"servers": {
"vault-mcp-tools": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
"OBSIDIAN_REST_TOKEN": "<OBSIDIAN_REST_TOKEN>",
"OBSIDIAN_REST_PORT": "<OBSIDIAN_REST_PORT>",
"OBSIDIAN_TRANSPORT": "<OBSIDIAN_TRANSPORT>",
"OBSIDIAN_HTTP_PORT": "<OBSIDIAN_HTTP_PORT>",
"OBSIDIAN_HTTP_AUTH_TOKEN": "<OBSIDIAN_HTTP_AUTH_TOKEN>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
OBSIDIAN_VAULT_PATHRequired | Absolute path to the Obsidian vault root directory |
OBSIDIAN_REST_TOKENOptional, secret | Bearer token for the Obsidian REST API (enables 3 bonus tools: execute_command, list_commands, open_in_obsidian) |
OBSIDIAN_REST_PORTOptional | REST API port (default: 27124) |
OBSIDIAN_TRANSPORTOptional | Transport mode: stdio (default) or http |
OBSIDIAN_HTTP_PORTOptional | HTTP transport port (default: 3000) |
OBSIDIAN_HTTP_AUTH_TOKENOptional, secret | Bearer token for HTTP transport authentication |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 11 Apr 2026 |
| Last updated | 11 Apr 2026 |
| Registry name | io.github.afable702/vault-mcp-tools |
More productivity servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.