{"_id":"@dan_cmos/obsidian-vault-mcp","_rev":"3-699dff01ae8fe2769e7bcfe435f9445d","name":"@dan_cmos/obsidian-vault-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@dan_cmos/obsidian-vault-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","obsidian","markdown","knowledge-base","llm","ai"],"author":{"name":"Daniel Mendes"},"license":"MIT","_id":"@dan_cmos/obsidian-vault-mcp@0.1.0","maintainers":[{"name":"dan_cmos","email":"senseidanielmendes@gmail.com"}],"homepage":"https://github.com/danielmendes/obsidian-mcp/tree/main/apps/obsidian-mcp#readme","bugs":{"url":"https://github.com/danielmendes/obsidian-mcp/issues"},"bin":{"obsidian-vault-mcp":"dist/index.js","multify-obsidian-mcp":"dist/index.js"},"dist":{"shasum":"0bdd4c65542675aa8f0b9d4f4ebb2a75a8ffc117","tarball":"https://registry.npmjs.org/@dan_cmos/obsidian-vault-mcp/-/obsidian-vault-mcp-0.1.0.tgz","fileCount":9,"integrity":"sha512-Fg4R0cGeyUuz+HyVQQi0K27BJY+ukigQBVhNw5WLrXiHI0Mwth+IP1umvJ/8q9uQvlawU5XihJahKoU73XjGxQ==","signatures":[{"sig":"MEYCIQCDu7fiJO8R4H4NqhXONEnAr59ZFbe7FTKIM7Plc15OWAIhAPXwcAiwlh0jUY+t2RoMNCh1ItCKETQvE06/vS3y6D2D","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24839},"main":"./dist/index.js","type":"module","engines":{"node":">=20"},"gitHead":"72b8c67aff8bc1634c1037ebd749a7b52c900601","mcpName":"io.github.danielmendes/obsidian-vault","scripts":{"dev":"tsx src/index.ts","test":"npm run test:prep && npm run test:run","build":"tsc -p tsconfig.json","check":"tsc --noEmit -p tsconfig.json","test:run":"node --test dist-tests/tests/*.test.js","test:prep":"tsc -p tsconfig.test.json","test:coverage":"node ../../scripts/check-node-test-coverage.cjs --cwd . --prepare-script test:prep --tests-dir dist-tests/tests --test-ext .test.js --min-line 90 --min-branch 75 --min-funcs 90","version:major":"node ../../scripts/version-mcp-release.cjs major","version:minor":"node ../../scripts/version-mcp-release.cjs minor","version:patch":"node ../../scripts/version-mcp-release.cjs patch","version:premajor":"node ../../scripts/version-mcp-release.cjs premajor","version:preminor":"node ../../scripts/version-mcp-release.cjs preminor","version:prepatch":"node ../../scripts/version-mcp-release.cjs prepatch","version:prerelease":"node ../../scripts/version-mcp-release.cjs prerelease"},"_npmUser":{"name":"dan_cmos","email":"senseidanielmendes@gmail.com"},"repository":{"url":"git+https://github.com/danielmendes/obsidian-mcp.git","type":"git","directory":"apps/obsidian-mcp"},"_npmVersion":"10.8.2","description":"MCP server for an authenticated local Obsidian bridge","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.18.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","typescript":"^5.9.2","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/obsidian-vault-mcp_0.1.0_1779213348894_0.16764215277567907","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Use 0.1.1; repository metadata was corrected."},"0.1.1":{"name":"@dan_cmos/obsidian-vault-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","obsidian","markdown","knowledge-base","llm","ai"],"author":{"name":"Daniel Mendes"},"license":"MIT","_id":"@dan_cmos/obsidian-vault-mcp@0.1.1","maintainers":[{"name":"dan_cmos","email":"senseidanielmendes@gmail.com"}],"homepage":"https://github.com/DanielMendesSensei/Obsidian-MCP/tree/main/apps/obsidian-mcp#readme","bugs":{"url":"https://github.com/DanielMendesSensei/Obsidian-MCP/issues"},"bin":{"obsidian-vault-mcp":"dist/index.js","multify-obsidian-mcp":"dist/index.js"},"dist":{"shasum":"0eb9507ea27dbfb71da6e458695571f19d956ede","tarball":"https://registry.npmjs.org/@dan_cmos/obsidian-vault-mcp/-/obsidian-vault-mcp-0.1.1.tgz","fileCount":9,"integrity":"sha512-zVuxHb/QcXiilFpHq4z4hNJ4+hFFH5719tI+PpdxM3NjleJKodcPCCCim3iIkLUFMVRrzMM9ci/OtcjVasHw4g==","signatures":[{"sig":"MEUCIQC2yUi/tDDozsZqYckt96I+jdt9qPybj1SU+HA+IKmfDQIgGACOkx9VtPolLQvWCc9EqMwY9TFZko6z/Zw8PSb3oQg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25108},"main":"./dist/index.js","type":"module","engines":{"node":">=20"},"gitHead":"72b8c67aff8bc1634c1037ebd749a7b52c900601","mcpName":"io.github.danielmendessensei/obsidian-vault","scripts":{"dev":"tsx src/index.ts","test":"npm run test:prep && npm run test:run","build":"tsc -p tsconfig.json","check":"tsc --noEmit -p tsconfig.json","test:run":"node --test dist-tests/tests/*.test.js","test:prep":"tsc -p tsconfig.test.json","test:coverage":"node ../../scripts/check-node-test-coverage.cjs --cwd . --prepare-script test:prep --tests-dir dist-tests/tests --test-ext .test.js --min-line 90 --min-branch 75 --min-funcs 90","version:major":"node ../../scripts/version-mcp-release.cjs major","version:minor":"node ../../scripts/version-mcp-release.cjs minor","version:patch":"node ../../scripts/version-mcp-release.cjs patch","version:premajor":"node ../../scripts/version-mcp-release.cjs premajor","version:preminor":"node ../../scripts/version-mcp-release.cjs preminor","version:prepatch":"node ../../scripts/version-mcp-release.cjs prepatch","version:prerelease":"node ../../scripts/version-mcp-release.cjs prerelease"},"_npmUser":{"name":"dan_cmos","email":"senseidanielmendes@gmail.com"},"repository":{"url":"git+https://github.com/DanielMendesSensei/Obsidian-MCP.git","type":"git","directory":"apps/obsidian-mcp"},"_npmVersion":"10.8.2","description":"MCP server for an authenticated local Obsidian bridge","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.18.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","typescript":"^5.9.2","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/obsidian-vault-mcp_0.1.1_1779214188126_0.8152146086241681","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-05-19T17:55:48.706Z","modified":"2026-05-19T18:13:33.251Z","0.1.0":"2026-05-19T17:55:49.032Z","0.1.1":"2026-05-19T18:09:48.280Z"},"bugs":{"url":"https://github.com/DanielMendesSensei/Obsidian-MCP/issues"},"author":{"name":"Daniel Mendes"},"license":"MIT","homepage":"https://github.com/DanielMendesSensei/Obsidian-MCP/tree/main/apps/obsidian-mcp#readme","keywords":["mcp","model-context-protocol","obsidian","markdown","knowledge-base","llm","ai"],"repository":{"url":"git+https://github.com/DanielMendesSensei/Obsidian-MCP.git","type":"git","directory":"apps/obsidian-mcp"},"description":"MCP server for an authenticated local Obsidian bridge","maintainers":[{"name":"dan_cmos","email":"senseidanielmendes@gmail.com"}],"readme":"# Obsidian Vault MCP\n\n`@dan_cmos/obsidian-vault-mcp` is an MCP server for an authenticated local Obsidian bridge.\n\nIt preserves the existing `obsidian_*` tool contract and `OBSIDIAN_BRIDGE_*` environment variables while allowing each consuming project to scope itself to a stable root inside a shared vault.\n\n## Security Model\n\n- the MCP only knows a bridge URL, a bearer token, and an optional project root\n- no absolute vault path is stored in git\n- the bridge token is generated and stored inside the Obsidian plugin\n- the bridge host is configurable for local Windows and WSL setups\n\n## Install\n\nFrom npm:\n\n```bash\nnpm install -g @dan_cmos/obsidian-vault-mcp\n```\n\nThe package currently targets the npm scope `@dan_cmos`.\n\nOr run without a global install from a compatible MCP client:\n\n```json\n{\n  \"mcpServers\": {\n    \"obsidian-vault\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dan_cmos/obsidian-vault-mcp\"],\n      \"env\": {\n        \"OBSIDIAN_BRIDGE_BASE_URL\": \"http://127.0.0.1:27124\",\n        \"OBSIDIAN_BRIDGE_TOKEN\": \"<copied-from-plugin>\",\n        \"OBSIDIAN_BRIDGE_PROJECT_ROOT\": \"Central Vault/Example Project\"\n      }\n    }\n  }\n}\n```\n\nFor local development from this repository:\n\n```json\n{\n  \"mcpServers\": {\n    \"obsidian-vault\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/apps/obsidian-mcp/dist/index.js\"],\n      \"env\": {\n        \"OBSIDIAN_BRIDGE_BASE_URL\": \"http://127.0.0.1:27124\",\n        \"OBSIDIAN_BRIDGE_TOKEN\": \"<copied-from-plugin>\",\n        \"OBSIDIAN_BRIDGE_PROJECT_ROOT\": \"Central Vault/Example Project\"\n      }\n    }\n  }\n}\n```\n\n## Required Local Environment\n\nDefault local setup:\n\n```env\nOBSIDIAN_BRIDGE_BASE_URL=http://127.0.0.1:27124\nOBSIDIAN_BRIDGE_TOKEN=<copied-from-plugin>\nOBSIDIAN_BRIDGE_PROJECT_ROOT=Central Vault/Example Project\n```\n\nWindows Obsidian plus WSL MCP client:\n\n```env\nOBSIDIAN_BRIDGE_BASE_URL=http://<windows-wsl-host-ip>:27124\nOBSIDIAN_BRIDGE_TOKEN=<copied-from-plugin>\nOBSIDIAN_BRIDGE_PROJECT_ROOT=Central Vault/Example Project\n```\n\n`OBSIDIAN_BRIDGE_PROJECT_ROOT` is optional. When set, the MCP automatically scopes:\n\n- `obsidian_list_notes`\n- `obsidian_search_notes`\n- `obsidian_upsert_note`\n- `obsidian_patch_heading`\n- `obsidian_patch_frontmatter`\n- `obsidian_read_note`\n- `obsidian_resolve_note`\n\nCompatibility notes:\n\n- `OBSIDIAN_PROJECT_ROOT` is accepted as an alias for `OBSIDIAN_BRIDGE_PROJECT_ROOT`\n- the legacy bin alias `multify-obsidian-mcp` remains available\n- `obsidian_*` tool names are unchanged\n\n## Tools\n\n- `obsidian_health`\n- `obsidian_list_notes`\n- `obsidian_resolve_note`\n- `obsidian_read_note`\n- `obsidian_search_notes`\n- `obsidian_upsert_note`\n- `obsidian_patch_heading`\n- `obsidian_patch_frontmatter`\n\n## Development\n\n```bash\nnpm install --package-lock=false\nnpm test\nnpm run check\nnpm run build\n```\n\n## Semantic Versioning\n\nThis package uses semantic versioning for the MCP surface:\n\n- `major`: breaking changes to MCP tool names, environment variables, output contracts, or runtime requirements\n- `minor`: new backward-compatible MCP capabilities\n- `patch`: backward-compatible fixes, packaging fixes, and security fixes\n- prereleases: use `prepatch`, `preminor`, `premajor`, or `prerelease` when you want an `-rc.N` style publish first\n\nVersion management commands:\n\n```bash\nnpm run version:patch\nnpm run version:minor\nnpm run version:major\nnpm run version:prepatch\nnpm run version:preminor\nnpm run version:premajor\nnpm run version:prerelease\n```\n\nEach command updates:\n\n- `package.json`\n- `src/version.ts`\n- `CHANGELOG.md`\n\n## Release\n\nThis package is released from the monorepo via `.github/workflows/release-mcp.yml`.\n\nBefore cutting a release:\n\n```bash\nnpm run version:patch   # or minor / major / prerelease\n```\n\nThen review `CHANGELOG.md`, run the repo release gate, and push the matching `mcp-vx.y.z` tag.\n","readmeFilename":"README.md"}