{"_id":"obsidian-mcp-brain","_rev":"20-ed22739a6752747cd4bdbac4029b0282","name":"obsidian-mcp-brain","dist-tags":{"latest":"1.5.2"},"versions":{"0.2.0":{"name":"obsidian-mcp-brain","version":"0.2.0","keywords":["mcp","obsidian","claude","server","oauth"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@0.2.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://github.com/a1ecbr0wn/obsidian-mcp-brain#readme","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"7aac21fd976a62a10a874afc02f6167b31b763e9","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-0.2.0.tgz","fileCount":10,"integrity":"sha512-A6Z3dhkiSQU1yh82EOOpkzAyb0+Q45d3oogoU0mOt89BCP7ZCjajazjbKu3WZRm2V7X0gedUlPnBelyHZMPPMw==","signatures":[{"sig":"MEYCIQDfdGUrOanf4pyY6T3St8pzbDJIUv5ST+wB4r2rcTZ6JwIhAPXDMZQEQMp/nE7Kn/c/6421Ea2sB50WZVUaDlHTu4AN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":116934},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"2c0c7f9f38da0cf16087e9d5ba21b1e4369fea79","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"a1ecbr0wn","email":"alec@noser.net"},"deprecated":"Security fix: fetch-binary-file could be pointed at loopback and cloud-metadata addresses via IPv4-mapped IPv6 URLs, and fails on real hostnames under Node 20+. Upgrade to 1.0.1 or later.","repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"11.19.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_0.2.0_1790547704231_0.1020988307937083","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"obsidian-mcp-brain","version":"0.3.1","keywords":["mcp","obsidian","claude","server","oauth"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@0.3.1","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://github.com/a1ecbr0wn/obsidian-mcp-brain#readme","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"5686e2c972e0067643d2e55e81f0003001637587","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-0.3.1.tgz","fileCount":10,"integrity":"sha512-dCfkdUsZdcpB1OY3a2SZkRpwyfH6l4FEMBfN3sVmdg2CqCINObh6i7/A5KKPyu8kXliMGXT5NHC2/T6wfn02aA==","signatures":[{"sig":"MEUCIQDpOFDToF1uDgWTsOD873C0sy7ANng+tzQw2d6CrDR+vAIgZWKY326OqdTdVikRn5hZsOIYUGq7wEQQh3fYSozTEUU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIFBhVLLkGBus988BTQ/lWuFnMWNnCIbmjM2+lQACeDOZAiEA0rsXBi/ZtDR5SCv/aIOfUaj2zZWbMR8bQKT2Vm5d3no=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":116934},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"c1c8bfbe19bb75ddf1688816325d95fd7cb2ee02","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"deprecated":"Security fix: fetch-binary-file could be pointed at loopback and cloud-metadata addresses via IPv4-mapped IPv6 URLs, and fails on real hostnames under Node 20+. Upgrade to 1.0.1 or later.","repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.1.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_0.3.1_1790549864844_0.23862318742274558","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"obsidian-mcp-brain","version":"0.4.0","keywords":["mcp","obsidian","claude","server","oauth"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@0.4.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://github.com/a1ecbr0wn/obsidian-mcp-brain#readme","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"23fd5dbd033f0c272312f54a1106f18791668caa","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-0.4.0.tgz","fileCount":10,"integrity":"sha512-WEkFkgpitgHRSzXuaHUkaE8AxaPRDU4ZYMUdA/5a1naupIU137c4yi4whPmSnTmQLDGMHGC3Iefxe1M5J0WN6w==","signatures":[{"sig":"MEUCIEcKNGxtbWWNULdXkq4u8S75yfAG8LQ7jso8dKpFh4r2AiEA5WEQPsOUw9/srzsl3N6NTppedO+c5jW7tOIYVNL3KFY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIB8BV6wM1zD8FVtVU4UkVYMubBIAeTNZN3qZyp/RUQM3AiEAi7whkvQ9QDKmfSNPaDdEYdu7hUO1kLNJ6TfWrzc31VQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":116934},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"a3d4819e78d5a05bd2b41a536f8628ad4a5f2334","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"deprecated":"Security fix: fetch-binary-file could be pointed at loopback and cloud-metadata addresses via IPv4-mapped IPv6 URLs, and fails on real hostnames under Node 20+. Upgrade to 1.0.1 or later.","repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.1.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_0.4.0_1790550070086_0.7780810691299183","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"obsidian-mcp-brain","version":"0.5.0","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@0.5.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://github.com/a1ecbr0wn/obsidian-mcp-brain#readme","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"4c74fcc9f59cdb7e0c5e7cc5d8fc7783414070e2","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-0.5.0.tgz","fileCount":11,"integrity":"sha512-DDKtYvi5iU1mKFLNOUjTie67788ytKnCovuTJlX/xbqa/LdBgk/72y7hRDplN8d53ZHN3SN3fvmi4hqHZ2jcGA==","signatures":[{"sig":"MEQCIBGZcpM5qNHZ5qbho2cywY47fDqPu3isoLpvZQeQSkYjAiAfFDQ8araMmAOHbL7THEfsm3sRiqVz1mu/VYVSLnAHIA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIHv2tGKzZ2CymydcFDzCigB5jC2037RSU+AK1UWye4KwAiEA1HoS8dW0inkHhzeoTzA6UfVbLEPTvk613aGQkx5Qk5c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":135914},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"8f5a0df92433f7d62b4920b0551b8fe2c2ce6627","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"deprecated":"Security fix: fetch-binary-file could be pointed at loopback and cloud-metadata addresses via IPv4-mapped IPv6 URLs, and fails on real hostnames under Node 20+. Upgrade to 1.0.1 or later.","repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.1.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_0.5.0_1790550873887_0.47314563460704084","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"obsidian-mcp-brain","version":"1.0.0","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.0.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://github.com/a1ecbr0wn/obsidian-mcp-brain#readme","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"5e25f868e79ed6d52cf4ce0385e7103e1ce42439","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.0.0.tgz","fileCount":11,"integrity":"sha512-qRYU6j9AZCpY/8O0jf4jwgkwL6+vy0ssOgUGe6JIBGJS0ozGhzCWXg4scsTeurGpLJOT2ZbJPaLXl1lhZIJG2Q==","signatures":[{"sig":"MEQCIHNZaz5nzDLhUcLJVKXuui4wIlz9UwcAmuQt0Oa+mvXaAiAvEi5h44A1S/7lUaC+uz91qR/m4wn1AabdW/Q0SsER+Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCWmYei0R6W+Zxq7qlWOo5PeBB7sAtGMViqbunn/D/QlwIgXpxceT48KBtub3n6+0WMx+WKYSHlpwSp4mvxL9bmP7Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":135743},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"45eae62a214cb541c8676e9ba0655fd5d88132fa","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"deprecated":"Security fix: fetch-binary-file could be pointed at loopback and cloud-metadata addresses via IPv4-mapped IPv6 URLs, and fails on real hostnames under Node 20+. Upgrade to 1.0.1 or later.","repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.1.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.0.0_1790551213238_0.31000428455020823","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"obsidian-mcp-brain","version":"1.0.1","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.0.1","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://github.com/a1ecbr0wn/obsidian-mcp-brain#readme","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"f7be83d0c25a710466598e48145f32c8d52567f3","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.0.1.tgz","fileCount":11,"integrity":"sha512-oDuLTE6BG7Ib1rovnFt4Gqo7sOQtPdlK9dtSJWh07xrjoC1TBBfkEiTaMbQ8CSXcojyBnb211K+mPq/BucaMZA==","signatures":[{"sig":"MEUCIDDksFLWeNtWGgNQX7JBp1DVHC3j6QH4QJzuVZCrIkmIAiEA/6cEkM3rageOKT+qbIUAWwKE0DG7/T2XzGzGMt7OaOU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIBYdnUkMuPq/PWYIvDw9XJYvgIdmRFyEEbxu2lq7WNxEAiEAgRWAzjmgHHYpmhHv4E0h17+TkHp2ZtkY70r7/KZjngU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":138375},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"a41f2853b63711099cb29f85742c42e3c235f922","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.1.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.0.1_1790609545407_0.02264535940339285","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"obsidian-mcp-brain","version":"1.0.2","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.0.2","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://brain.a1ecbr0wn.com","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"eb88d180511c19937a001d8918b18c5e6f622a49","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.0.2.tgz","fileCount":11,"integrity":"sha512-9VoiahwzaG6c2b+Mp7DzocbEcvknu9XVjTMRBjSrMDHn+DyNe178gI5POajew1ukKY2D3XWCAhCHKoM/84XkpA==","signatures":[{"sig":"MEUCIA4frRD6mH7ajerNNDF5zRAOp5DNVY+vrqG+8ObY7JnGAiEAitA6e0KXsnoxIs/RqwpB5u2KlQ3du8LFIE1A4k5KPeE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDc4hLnMAYDmLhamNiivrd4gHGIuldgIPhbL0gEKofqnAIgMgxVR3ZBmZYY4jKp8J0uSXVwGtm+ZZswJXdPxPXyYEU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":138669},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"7000a9386a371770bae84e5607ebbf537967c30c","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.1.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.0.2_1790631645222_0.32678852599546704","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"obsidian-mcp-brain","version":"1.0.3","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.0.3","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://brain.a1ecbr0wn.com","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"9e9c0dbc2772e08a2aef7761f433893ff236b70e","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.0.3.tgz","fileCount":11,"integrity":"sha512-dWjvFhZjVjbTeUYDOqN6Ty/Tqmrl/anNhgv1+dDqtOwPvVqQSS/a8f+QM7SzKFAElYuP1vAlayf8BE8E7uYNOA==","signatures":[{"sig":"MEQCICe5A+GMVFqKf/VkSLvBl1SSvQiph9RtibiUos2/Bt0iAiBMxKS6SRH2dX7pd/pkF/DUqFcq8Y5u4/HO8CnEOFzT5Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCICVFkOmGYvlSLiVP9n5Hb3rD5NI5MWFszhNuWIGa79HIAiAblsu+7BzZxDiBQ6MWj8ox45lerucSigEyQCLa3OZ6GQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":141647},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"ce6d0592df3506ad5a44cd5bdf5c4a48a1ae6223","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.1.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.0.3_1790784319632_0.7128238104596571","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"obsidian-mcp-brain","version":"1.1.0","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.1.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://brain.a1ecbr0wn.com","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"a09feb1d9eb7635d68e2946128d6815c11a2ef0a","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.1.0.tgz","fileCount":13,"integrity":"sha512-ZHfQAQocz26AlrXIJRqcG/bTD4LD084s6bYiNB+5cpEljAcJh0H52eFsGa+1olRUzmx9mH0KEydnOMOLYRHm9Q==","signatures":[{"sig":"MEYCIQCQVuVOzocbmz7WBj0ePbIErj3WIPDITdiI68fg4T5e5AIhAL4wc7/RoKJeyNPzh/PPTCVC9iAk6YL4ezp3x/OWZwfx","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHi2Osl5cdkERpoQlPcw3YKaALX4USU2rNjv8Vlfsx/yAiBMswK6R0jbGhK1ZYqhpNQjpfKdA+yBxWYMP6rNEFFkTA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":205053},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"c70728107f0abd2d47595127ecb0e983572f1850","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.2.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.1.0_1791676386482_0.1385437039665478","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"obsidian-mcp-brain","version":"1.2.0","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.2.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://brain.a1ecbr0wn.com","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"f00e75c4c2f7e72cecaba656de733afe9ce7684b","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.2.0.tgz","fileCount":13,"integrity":"sha512-+QCgoU8OLXVOK0kWupYzc0oBHK8eN3DXvXrz4xUzQbcO0jKnMWKbSzyyXuxPAwVA0QfaQC9IaxnTV5OmFcKnrg==","signatures":[{"sig":"MEUCIQCeSFfChSgelxDFXzxUegYC3kjQYgy14M2/4ZjaCJJP3QIgD+H5t3J5xK5zBC4A/UX72ZFcnSV7twrGcYBg7VRXbXs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDf3X4VBL/A63VlyB8JGFo7AEzrosh/53DjB2zretp3lQIgUlwSY18IwZvDHig6bjPo3ajk5nqHTpaVMnW7ZsGWo8Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":212165},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"f0797e5892195b481f21b3b146aaf86f04c20a66","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.2.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.2.0_1791846559113_0.19280366355750544","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"obsidian-mcp-brain","version":"1.3.0","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.3.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://brain.a1ecbr0wn.com","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"92d4f93b49a2513565cb9bb2a984f4fd7dfd9c80","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.3.0.tgz","fileCount":14,"integrity":"sha512-j79JHWwl2b0giUqYpZcGEefRIxaTKJuhghjmLk7J9flqYcKORSnynn+NX0y4nEYJ48FkNaWU7dKxRXriAye+Tw==","signatures":[{"sig":"MEQCIBNWwhgeIvuKVYNPA9UbrH/I5bOo3iJa3O51fr9QR06YAiBmFLSI5i8vEyyes2fvTNLNsLeqJ6dTgg6rGGMXbOA0xw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQChMlKfWhrPkPV/lZKZE28ZrOdc2elxgaT6hFrQN6HFZgIhAI8rdtawR32VARc5RpjwbxmuFvgwZaamG76muzNDjfTK","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":241599},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"7c26ea7b1fc8b029cd99555f68076dcdc9ee31dd","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.2.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.3.0_1792105713375_0.01440282252502989","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"obsidian-mcp-brain","version":"1.4.0","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.4.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://brain.a1ecbr0wn.com","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"39f0075c405d7f18fc4fceb83a5af0795dea136e","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.4.0.tgz","fileCount":19,"integrity":"sha512-gHgMtoo+ajh12vomF3eudoHFOc3lN3CyUhKAlQLDyKsKrY9tpmSO58Zfid/2aiYiVYPMnCUvj3tEHvVNRDTFFQ==","signatures":[{"sig":"MEYCIQD9Uz5jOHxNI4vR3AP04SzG8/vnhfy4S05U1VwAiok5/AIhAOjadx/rcBEpehSvzLcYNQ4rfkJebRew+Z7d/Lx6YhvU","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDKKX0ZMam7ha9ywTXnOTy4dbwqhowTTtSCyuKITqKV8AIgJI+ZjxSr4hyWcFzLepC3nZI01bPyezmj99nYemaSiio=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":285329},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"aa9607665eff4f1dcb1b43ef795a7191adfabba1","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.2.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.4.0_1792186977803_0.5181129094799712","host":"s3://npm-registry-packages-npm-production"}},"1.5.0":{"name":"obsidian-mcp-brain","version":"1.5.0","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.5.0","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://brain.a1ecbr0wn.com","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"9099515ef8551f7f5b26d6b4a13c6c9e5aba59f1","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.5.0.tgz","fileCount":19,"integrity":"sha512-RWOxMKy5XGk8Ot1ebsM2JTRlbHMi/PEAhKMJHS4Cvw9OlYjXoVpUPA/ZlL5MBnXeFbYd9n92GWO1UQvMa5vBcg==","signatures":[{"sig":"MEYCIQDXIfqaSNNjxTabl24HsbW2Zd1GYkhTK3u5fUBRgySr4QIhAIV2QT8bXdpM64YDu4O8xuXmac4gmXu50FCaDV6Z/JGQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCICREwBISXn3jfXPzKbN6OeIMMfUBH/simz+ugthdG74yAiB9rIJ27oo50Mf40dFXkbeXWCUvbr0+D3XHBMT1Yf+vlw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":286523},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"ee86b3201ca61c21cd32794ab23edd975d957c3c","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.2.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.5.0_1792345853120_0.5618395176440054","host":"s3://npm-registry-packages-npm-production"}},"1.5.1":{"name":"obsidian-mcp-brain","version":"1.5.1","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","_id":"obsidian-mcp-brain@1.5.1","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"homepage":"https://brain.a1ecbr0wn.com","bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"dist":{"shasum":"70a672c8f9b12069e2620ca14be10c5826da6e6c","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.5.1.tgz","fileCount":22,"integrity":"sha512-twjNDTD7h+AJkQ6pghJizm02tsGWUendJbqIAmjKyNwhPMlJtsPHQyMSjwSRjP+xP7nrbe5Cpv0DN3jNUITjqQ==","signatures":[{"sig":"MEQCIHgp5JJeI/bA2QfdW+XlekY403eJTpqQydRSTcoPb4qRAiAW+3bWww2+p1mUtIIykqY3hhdH5EFa9HBU/CXSEV4nvA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDkf6cIua8EX5GgeMAi7cou7iOUEfFJM3ZUCDugZY+E9QIhANnZ4DNlSahnWNSztTKzc83XuL9kmmw6SI+6bXvKwQ48","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.5.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":329429},"main":"obsidian-mcp-brain.mjs","type":"module","engines":{"node":">=18"},"gitHead":"9252b66b991cf885c7d79c286ae523f9a722c49e","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.2.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"_nodeVersion":"22.23.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp-brain_1.5.1_1792392261189_0.15619852187205585","host":"s3://npm-registry-packages-npm-production"}},"1.5.2":{"_id":"obsidian-mcp-brain@1.5.2","bin":{"obsidian-mcp-brain":"obsidian-mcp-brain.mjs"},"bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"dist":{"shasum":"c04fed8351b42d63febfd4ab922925da2af98064","tarball":"https://registry.npmjs.org/obsidian-mcp-brain/-/obsidian-mcp-brain-1.5.2.tgz","fileCount":22,"integrity":"sha512-hWoX42YnnZx0UwxiWAKW0VlcHjuzOYbcpov1M/ytMhOImlL9aLHs4DlQCq78BcXabnm2DnhNdV+gLUGI8AZGdg==","signatures":[{"sig":"MEQCIAS72S49oG+scVwSl4YavzXnvRqyP1iJ9N+WgmTYup/XAiBBxTs3gSa0bSeCC6jQyei/A1CXaSqT2meVkjFADuOTxw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGae0+biPHMQ1wK0ijwiL6Stoly6b21NOOsoxXxFgw3yAiEAiTXCP6vFi6xDR2y6aXfzp+oeURVZiggAOHC5Rzp5ym4="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/obsidian-mcp-brain@1.5.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":334521},"main":"obsidian-mcp-brain.mjs","name":"obsidian-mcp-brain","type":"module","author":{"name":"a1ecbr0wn"},"engines":{"node":">=18"},"gitHead":"031669a1a7e3ab2f7910ef2a1f52a5c517b8c96c","license":"Apache-2.0","scripts":{"test":"node --test test/*.test.mjs"},"version":"1.5.2","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ff35bfcd-2e47-4411-98ff-67ee9e4df4c0"}},"homepage":"https://brain.a1ecbr0wn.com","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"_npmVersion":"12.2.0","description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","directories":{},"maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"_nodeVersion":"22.23.3","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/obsidian-mcp-brain_1.5.2_1792452438997_0.5381436486968447"}}},"time":{"created":"2026-09-27T22:21:44.096Z","modified":"2026-10-19T23:27:19.476Z","0.2.0":"2026-09-27T22:21:44.427Z","0.3.1":"2026-09-27T22:57:44.925Z","0.4.0":"2026-09-27T23:01:10.393Z","0.5.0":"2026-09-27T23:14:33.970Z","1.0.0":"2026-09-27T23:20:13.320Z","1.0.1":"2026-09-28T15:32:25.498Z","1.0.2":"2026-09-28T21:40:45.304Z","1.0.3":"2026-09-30T16:05:19.721Z","1.1.0":"2026-10-10T23:53:06.568Z","1.2.0":"2026-10-12T23:09:19.214Z","1.3.0":"2026-10-15T23:08:33.469Z","1.4.0":"2026-10-16T21:42:57.911Z","1.5.0":"2026-10-18T17:50:53.201Z","1.5.1":"2026-10-19T06:44:21.279Z","1.5.2":"2026-10-19T23:27:19.082Z"},"bugs":{"url":"https://github.com/a1ecbr0wn/obsidian-mcp-brain/issues"},"author":{"name":"a1ecbr0wn"},"license":"Apache-2.0","homepage":"https://brain.a1ecbr0wn.com","keywords":["mcp","mcp-server","model-context-protocol","obsidian","obsidian-vault","obsidian-brain"],"repository":{"url":"git+https://github.com/a1ecbr0wn/obsidian-mcp-brain.git","type":"git","directory":"obsidian-mcp-brain"},"description":"MCP server exposing Obsidian vaults to remote clients (Claude Code, Claude Desktop) with OAuth discovery and path-level access control","maintainers":[{"name":"a1ecbr0wn","email":"alec@noser.net"}],"readme":"# obsidian-mcp-brain\n\nA thin Node.js HTTP server that provides remote MCP access to an Obsidian vault.\nIt implements all MCP tools natively and exposes them to remote clients such as\nClaude Code and Claude Desktop via HTTP.\n\n## Why this server is needed\n\nRemote MCP clients (Claude Code 2.x, Claude Desktop) connect over HTTP, not\nstdio, and the standard approaches have issues:\n\n### No HTTP transport for local MCP servers\n\nExisting solutions like [`mcp-proxy`](https://github.com/sparfenyuk/mcp-proxy)\nwrap stdio MCP servers and expose them over HTTP. However, mcp-proxy has a\nsession-management bug: when Claude Code opens its GET `/mcp` notification\nstream at the same time as sending tool-list requests (which it always does),\nmcp-proxy's response routing gets confused and `tools/list` silently times out.\nThis server implements the MCP HTTP transport layer directly and implements all\ntools natively, eliminating that class of bug.\n\n### No OAuth 2.0 discovery\n\nThe [MCP 2025-03-26 spec](https://spec.modelcontextprotocol.io) requires every\nnon-localhost remote MCP server to expose OAuth 2.0 discovery endpoints\n(`/.well-known/oauth-protected-resource`,\n`/.well-known/oauth-authorization-server`, `/authorize`, `/token`, `/register`).\nWithout them, Claude Code refuses to connect. This server serves a public (no\ncredentials required) OAuth flow so that Claude Code's auth handshake completes\nwithout needing real credentials.\n\n### What this server does\n\n```text\nClaude Code / Claude Desktop\n        │  HTTPS (e.g. Tailscale)\n        ▼\nobsidian-mcp-brain  :3002\n  ├─ OAuth 2.0 discovery endpoints\n  ├─ MCP Streamable HTTP transport (POST /mcp, GET /mcp)\n  ├─ Path deny list (access control)\n  └─ Vault access (node:fs/promises)\n        │\n        ▼\nObsidian vault (filesystem)\n```\n\n---\n\n### Prerequisites\n\n- Node.js 18+\n- A way to expose the server over HTTPS to your remote client — [Tailscale\n  Serve](https://tailscale.com/docs/features/tailscale-serve) is recommended,\n  because it also keeps the server on an overlay network, but any HTTPS reverse\n  proxy on a private network works\n- **Optional:** The `query-graph` tool (which queries a vault using a\n  natural-language knowledge graph) requires the `graphify` CLI to be installed\n  and on `PATH`, and a knowledge graph to be pre-built for that vault (run\n  `graphify --obsidian` against it once, before calling the tool). `query-graph`\n  is always listed, but calling it against a vault with no graph returns a clear\n  error rather than an answer.\n\n---\n\n### Installation\n\n```bash\nnpm install -g obsidian-mcp-brain\n```\n\nThis puts an `obsidian-mcp-brain` command on your `PATH`. Then set it up as a\npersistent service.\n\n### systemd (Linux)\n\nFirst, create your config file — see [Configuration](#configuration) below for\nits full shape. By default the server reads `~/.config/obsidian-mcp.json`, so no\nextra environment variable is needed unless you want the config somewhere else.\n\nThen create `~/.config/systemd/user/obsidian-mcp.service`:\n\n```ini\n[Unit]\nDescription=Obsidian MCP Server\nAfter=network.target\n\n[Service]\nExecStart=/usr/bin/env obsidian-mcp-brain\nRestart=on-failure\nRestartSec=5\n\n[Install]\nWantedBy=default.target\n```\n\n(If your config file lives somewhere other than `~/.config/obsidian-mcp.json`,\nadd `Environment=CONFIG_PATH=/path/to/your/config.json` under `[Service]`.)\n\nThen enable and start it:\n\n```bash\nsystemctl --user daemon-reload\nsystemctl --user enable --now obsidian-mcp.service\n```\n\n### macOS (launchd)\n\nCreate `~/Library/LaunchAgents/com.obsidian-mcp-brain.plist`:\n\n```xml\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\"\n  \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n  <key>Label</key>\n  <string>com.obsidian-mcp-brain</string>\n\n  <key>ProgramArguments</key>\n  <array>\n    <string>/usr/local/bin/obsidian-mcp-brain</string>\n  </array>\n\n  <!-- Only needed if your config file isn't at the default\n  ~/.config/obsidian-mcp.json -->\n  <key>EnvironmentVariables</key>\n  <dict>\n    <key>CONFIG_PATH</key>\n    <string>/path/to/your/obsidian-mcp.json</string>\n  </dict>\n\n  <key>RunAtLoad</key>\n  <true/>\n  <key>KeepAlive</key>\n  <true/>\n\n  <key>StandardOutPath</key>\n  <string>/tmp/obsidian-mcp-brain.log</string>\n  <key>StandardErrorPath</key>\n  <string>/tmp/obsidian-mcp-brain.log</string>\n</dict>\n</plist>\n```\n\nLoad it:\n\n```bash\nlaunchctl load ~/Library/LaunchAgents/com.obsidian-mcp-brain.plist\n```\n\nTo restart after a config change:\n\n```bash\nlaunchctl unload ~/Library/LaunchAgents/com.obsidian-mcp-brain.plist\nlaunchctl load   ~/Library/LaunchAgents/com.obsidian-mcp-brain.plist\n```\n\n### Docker\n\nInstead of installing Node.js, you can run the server from the container image\npublished to the GitHub Container Registry for `linux/amd64` and `linux/arm64`.\nIt is configured with the same JSON file as every other install; only two things\ndiffer from a native run:\n\n- `listenHost` must be `\"0.0.0.0\"`, so the port you publish can reach the server\n  inside the container (the default, `127.0.0.1`, is unreachable from outside\n  it).\n- Vault paths in the config are paths *inside* the container, so mount each\n  vault there (below, at `/vaults/knowledge`).\n\n```json\n{\n  \"listenHost\": \"0.0.0.0\",\n  \"mcpBaseUrl\": \"https://your-hostname:4001\",\n  \"vaults\": {\n    \"knowledge\": { \"path\": \"/vaults/knowledge\" }\n  }\n}\n```\n\n```bash\ndocker run -d --name obsidian-mcp-brain --restart unless-stopped \\\n  --user \"$(id -u):$(id -g)\" \\\n  -v /path/to/your/obsidian/vault:/vaults/knowledge \\\n  -v /path/to/obsidian-mcp.json:/config/obsidian-mcp.json:ro \\\n  -p 127.0.0.1:3002:3002 \\\n  ghcr.io/a1ecbr0wn/obsidian-mcp-brain\n```\n\nThe port is published on the host's loopback only, so put HTTPS in front of it\nthe same way as for a native install (the Tailscale Serve command below works\nunchanged). `--user` makes the container write to your vault as you; without it\nthe container runs as an unprivileged user with UID 1000. If you change\n`listenPort`, publish that port instead of `3002`.\n\nThe image does not include `graphify`, so `query-graph` always returns an error\nin a container (\"graphify command not found on PATH\" once the vault has a\ngraph); use a native install if you need that tool. Everything else works. See\nthe [Docker install guide](https://brain.a1ecbr0wn.com/install/install-docker)\nfor a `docker compose` example and hardening options.\n\n### Tailscale Serve (HTTPS tunnel)\n\nPoint Tailscale at the server's local port:\n\n```bash\nsudo tailscale serve --bg --https 4001 http://localhost:3002\n```\n\nThis exposes the server at `https://<your-tailscale-hostname>:4001`.\n\nThere are step-by-step pages, with the settings this server needs and why, for\n[Tailscale Serve](https://brain.a1ecbr0wn.com/install/install-tailscale),\n[nginx](https://brain.a1ecbr0wn.com/install/install-nginx) and\n[Caddy](https://brain.a1ecbr0wn.com/install/install-caddy).\n\n---\n\n## Configuration\n\nAll configuration lives in one JSON file — no environment variables are read\nexcept `CONFIG_PATH`, which says where to find it.\n\n- **Location**: `CONFIG_PATH` env var if set, otherwise\n  `~/.config/obsidian-mcp.json`.\n- The server serves one or more named vaults from a single process; a client\n  picks which one a call applies to via the `vault` argument every tool except\n  `list-vaults` and `get-setup-status` takes.\n\n### Shape\n\n```json\n{\n  \"listenPort\": 3002,\n  \"listenHost\": \"127.0.0.1\",\n  \"mcpBaseUrl\": \"https://your-hostname:4001\",\n  \"denyPaths\": [\"private\"],\n  \"denyBinaryPaths\": [\"**/*.pdf\"],\n  \"graphifyQueryTimeoutMs\": 60000,\n  \"fetchMaxBytes\": 10485760,\n  \"fetchTimeoutMs\": 30000,\n  \"readMaxBytes\": 10485760,\n  \"readNoteMaxChars\": 50000,\n  \"uploadMaxBytes\": 52428800,\n  \"uploadTtlSeconds\": 300,\n  \"uploadStallSeconds\": 30,\n  \"uploadNetworkPrefix\": 0,\n  \"logFile\": \"/var/log/obsidian-mcp.log\",\n  \"sessionTimeoutSeconds\": 1800,\n  \"trashRetentionDays\": 30,\n  \"uploadTempDir\": \"/var/tmp/obsidian-mcp-uploads\",\n  \"trustedProxies\": [\"127.0.0.1\", \"::1\"],\n  \"vaults\": {\n    \"knowledge\": {\n      \"path\": \"/path/to/your/obsidian/vault\"\n    },\n    \"work\": {\n      \"path\": \"/path/to/another/vault\",\n      \"denyPaths\": [\"confidential\"],\n      \"denyBinaryPaths\": [\"scans\"]\n    }\n  }\n}\n```\n\n| Field                    | Required | Default                                                       | Description                                                                                                                                                                           |\n| ------------------------ | -------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `mcpBaseUrl`             | Yes      | —                                                             | Public HTTPS base URL of the server (scheme, host and port, no path or trailing slash); used in OAuth responses, SSE endpoint events and upload URLs                                  |\n| `mcpPath`                | No       | `/mcp`                                                        | Path of the MCP endpoint, added to `mcpBaseUrl`; starts with `/`, no trailing slash, no empty or dot segments                                                                         |\n| `vaults`                 | Yes      | —                                                             | Non-empty object of `{ \"name\": { \"path\": \"...\" } }`. Each vault needs at least a `path`                                                                                               |\n| `listenPort`             | No       | `3002`                                                        | Local port the server listens on                                                                                                                                                      |\n| `listenHost`             | No       | `127.0.0.1`                                                   | Address the server binds to. Leave it as loopback unless the server runs in a container, where `0.0.0.0` is needed for the published port to reach it                                 |\n| `denyPaths`              | No       | `[]`                                                          | Vault-relative paths to block, applied to every vault. See below                                                                                                                      |\n| `denyBinaryPaths`        | No       | `[]`                                                          | Vault-relative files/folders, with wildcards, whose binary files `read-file` refuses to return. See below                                                                             |\n| `graphifyQueryTimeoutMs` | No       | `60000`                                                       | Timeout for a `graphify query` subprocess (milliseconds)                                                                                                                              |\n| `fetchMaxBytes`          | No       | `10485760`                                                    | Default max response size for `fetch-file` (bytes); overridable per call                                                                                                              |\n| `fetchTimeoutMs`         | No       | `30000`                                                       | Default request timeout for `fetch-file` (milliseconds); overridable per call                                                                                                         |\n| `readMaxBytes`           | No       | `10485760`                                                    | Largest file `read-file` will return (bytes, measured on disk)                                                                                                                        |\n| `readNoteMaxChars`       | No       | `50000`                                                       | Longest text `read-note` returns in one go (characters); longer notes are read by outline and heading                                                                                 |\n| `uploadMaxBytes`         | No       | `52428800`                                                    | Largest file `upload-file` will reserve an upload for (bytes)                                                                                                                         |\n| `uploadTtlSeconds`       | No       | `300`                                                         | How long an upload URL lasts (seconds)                                                                                                                                                |\n| `uploadStallSeconds`     | No       | `30`                                                          | How long an upload may send nothing before it is cut off (seconds)                                                                                                                    |\n| `uploadTempDir`          | No       | `obsidian-mcp-uploads-<user id>` under the system temp folder | Absolute path where uploads are held while received; must not be inside a vault and must belong to the server's user                                                                  |\n| `uploadNetworkPrefix`    | No       | `0`                                                           | Whether an upload must come from the address that reserved its URL: 0 for no check, or the leading bits of an IPv4 address that must agree, 16 to 32                                  |\n| `trustedProxies`         | No       | `[]`                                                          | Addresses or CIDR ranges of reverse proxies whose `X-Forwarded-For` is believed. See below                                                                                            |\n| `logFile`                | No       | `none`                                                        | Absolute path of a file to append the log to, as well as the console. Includes the audit log                                                                                          |\n| `sessionTimeoutSeconds`  | No       | `1800`                                                        | How long a session may be idle before it is removed, in seconds (at least 60)                                                                                                         |\n| `trashRetentionDays`     | No       | `30`                                                          | Days a file stays in `.trash` before it is deleted (`0`: for ever)                                                                                                                    |\n| `auth`                   | No       | none                                                          | Accept only signed tokens from an external OAuth service, for the users you list. Off by default. See [Authentication](https://brain.a1ecbr0wn.com/configuration#authentication-auth) |\n\nEach vault entry can also set its own `denyPaths` and `denyBinaryPaths`, which\nare added on top of the global list for that vault only (see below).\n\n### Path deny list (`denyPaths`)\n\n`denyPaths` lets you prevent the MCP client from reading or writing specific\nfolders in a vault. Paths are relative to the vault root and prefix-matched, so\ndenying `people` blocks `people/`, `people/alice/notes.md`, and so on.\n\nThe top-level `denyPaths` applies to every configured vault. A vault's own\n`denyPaths` (if any) is added on top of that global list, restricting that vault\nfurther without affecting any other vault:\n\n```json\n{\n  \"denyPaths\": [\"private\"],\n  \"vaults\": {\n    \"knowledge\": { \"path\": \"/path/to/your/obsidian/vault\" },\n    \"work\": { \"path\": \"/path/to/another/vault\", \"denyPaths\": [\"confidential\", \"drafts\"] }\n  }\n}\n```\n\nHere, both vaults block `private`; `work` additionally blocks `confidential` and\n`drafts`, while `knowledge` is unaffected by that extra restriction.\n\nThe deny list is enforced before the tool reads or writes any file. Blocked\nrequests receive a structured MCP error (`isError: true`) rather than a\ntransport-level failure, so the client can report the reason clearly.\n\nAffected tools: `read-note`, `create-note`, `edit-note`, `delete-note`,\n`move-note` (source and destination), `create-file`, `fetch-file`,\n`read-file`, `delete-file`, `move-file` (source and\ndestination), `find-backlinks`, `resolve-wikilink`, `add-tags`, `remove-tags`,\n`set-frontmatter-field`, `remove-frontmatter-field`, `create-folder`,\n`search-vault` (when a `path` scope is given).\n\n`list-notes`, `list-files`, `list-tags`, `search-tags`, `new-notes`,\n`changed-notes`, and `rename-tag` are equally protected, just via a different\nmechanism: instead of a single check up front, they filter out denied files\nindividually as they walk the vault.\n\n`list-vaults` doesn't touch vault files at all — it just returns configured\nvault names — so it's the only tool genuinely unaffected by the deny list.\n`query-graph` takes a free-text question rather than a vault path, so it isn't\nsubject to the deny list either. **Warning**: if the graphify graph was built\nover denied folders, the tool can reveal their content; build the graph from a\nvault without denied folders, or leave the tool unused.\n\n### Write preconditions (`expectedMtime`)\n\nEvery tool that writes to an existing file accepts an optional `expectedMtime`:\nthe ISO 8601 last-modified timestamp you previously got back from `read-note` or\n`list-notes`. Pass it back on a later write and the server refuses the write —\nwith no changes made — if the file's mtime has moved since, telling you both the\ntimestamp you expected and its actual current one so you know to re-read and\nretry.\n\nThis is a compare-and-swap check, not a lock: it's meant to catch \"I read this\nnote a while ago, and something else touched it since,\" not to serialize\nconcurrent writers. It's optional so existing callers are unaffected, but a\nclient following a read-then-write pattern (read a note, decide what to change,\nwrite it back) should always pass it — otherwise an edit made by something else\nin between is silently overwritten.\n\n```text\nread-note  → note content + Last-Modified: 2026-09-20T10:15:00.000Z\n...decide what to change...\nedit-note  → { operation: \"replace\", content: \"...\", expectedMtime: \"2026-09-20T10:15:00.000Z\" }\n```\n\nApplies to: `edit-note` (all operations), `delete-note`, `move-note` (checked\nagainst the source file), `set-frontmatter-field`, `remove-frontmatter-field`,\n`move-file` and `delete-file` (checked against the source file).\nFor `add-tags`/`remove-tags`, which operate on a `files[]` array,\n`expectedMtime` is instead an object mapping each vault-relative path to its\nexpected timestamp; every listed file's precondition is checked before any file\nin the batch is written, so the batch either applies wholly or not at all.\n\nNot applicable to `create-note`, `create-file`, or `fetch-file`,\nwhich already fail if the destination exists, nor to `rename-tag`, which sweeps\nthe whole vault rather than targeting one file.\n\n### edit-note operations\n\nBeyond `append`, `prepend`, and `replace`, `edit-note` supports targeted,\nsection-scoped edits so a large note doesn't need to be resent in full for a\nsmall change:\n\n- **`replace-section`** — replaces the content under a heading (matched by exact\n  text, without the `#` characters), leaving the heading line itself in place.\n  Everything under the heading goes, sub-sections included, up to the next\n  heading of the same or a higher level. `content` is the new body only, so\n  don't repeat the heading; to rename a heading, use `replace`. A `content` of\n  only white space clears the section.\n- **`delete-section`** — removes a heading and everything under it, heading line\n  and sub-sections included. When the section is the last thing in the note, the\n  blank lines before it go too and the note keeps its final newline. A line of\n  only `#` characters is not a heading, so a section runs through it and both\n  operations remove it with the rest.\n- **`toggle-checkbox`** — flips (or explicitly sets) a `- [ ]`/`- [x]` line,\n  matched by its exact text.\n\nIf a `heading` or `taskText` match isn't unique in the note, the call fails with\na list of every match (line number, and heading level where relevant); pass the\n1-based `occurrence` from that list on a follow-up call to disambiguate.\n\nTools that change a note write the text they make in the note's own line ending\n(CRLF or LF, taken from its first line break) and leave the other lines as they\nwere: `append`, `prepend`, `replace-section`, the tag and frontmatter tools, and\nthe tag line `add-tags` puts in the body. `create-note`, `replace` and\n`create-file` write what they are sent.\n\n#### Listing files\n\n`list-files` lists every kind of file, so an agent can find the scripts, PDFs and\nimages that `read-file`, `replace-file`, `move-file` and the other file tools\nwork on. Give it an `extension` to narrow the list. `list-notes` lists the\nnotes (`.md` files) only and takes no `extension`: a call that passes one, with\nany value, is refused with a message that names `list-files`.\n\n| `extension` | Lists |\n| --- | --- |\n| *(omitted)* | Every file |\n| `md` | The notes: files ending in `.md`, in any letter case (`list-notes` lists these without being asked) |\n| `pdf` | Every PDF |\n| `p*` | `pdf`, `png` and anything else starting with `p` |\n| `*` | Every file, whatever its extension |\n\n- Give the extension without a dot: `pdf`, not `.pdf` or `*.pdf`. `*` matches\n  any run of characters and `?` one character.\n- Case is ignored, so `jpg` finds `IMG_0001.JPG`.\n- The extension is the text after the last dot, so `gz` finds `backup.tar.gz`. A\n  file with no extension is listed only by `*`.\n- Each line is the vault-relative path, which includes the extension, then the\n  last-modified timestamp; `list-files` adds the size in bytes as a third field\n  (`list-notes` lines have the path and timestamp only).\n  Fields are separated by tabs. `path` scopes the listing to a folder. Neither\n  tool reads a file's content, so neither gives a hash: `read-file` does.\n- Hidden files and folders (names starting with a dot, such as `.obsidian` and\n  `.trash`) and symbolic links are not listed. If `path` is itself a hidden\n  folder, only its notes are listed, whatever `extension` says (`list-files`).\n- `extension` (`list-files` only) is at most 64 characters and has no spaces\n  at either end.\n- `denyPaths` applies.\n  [`denyBinaryPaths`](#binary-read-protection-denybinarypaths) does not hide\n  names: it only stops a file's content being read.\n\n#### Reading part of a note\n\n`read-note` refuses a note longer than `readNoteMaxChars` (50,000 characters by\ndefault) instead of returning something the client then rejects. Call it with\n`outline: true` to list the note's headings (line range, size of the section,\nwhich occurrence of that text it is), then with `heading` (and `occurrence`, if\nit repeats) to read one section: the heading line and everything under it up to\nthe next heading of the same or a higher level, sub-sections included, without\nthe blank lines that follow it. A heading from the outline can be passed\nstraight to `edit-note`. See the [tools\npage](https://brain.a1ecbr0wn.com/tools#reading-part-of-a-note).\n\n### fetch-file\n\n`create-file` requires the client to send the file as base64 — expensive\nthrough an LLM client, since base64 is read in and written out again on top of\nits already-larger-than-binary size. `fetch-file` instead has the server\ndownload a URL itself and write the result, so the client only ever sends a URL\nstring.\n\n```text\nfetch-file → { filename: \"photo.jpg\", folder: \"attachments\", url: \"https://example.com/photo.jpg\" }\n```\n\nBecause the server performs the request itself, a caller-supplied URL is\neffectively asking this host to make an arbitrary outbound call — on any\ndeployment, this host may be able to reach private network services that\nshouldn't be exposed to a remote MCP client. `fetch-file` treats this as\nits primary risk:\n\n- Only `http`/`https` URLs are accepted.\n- The hostname is resolved and the request is refused if any resolved address is\n  loopback, link-local, RFC1918, CGNAT, IETF\n  protocol/benchmarking/documentation, multicast, reserved (all IPv4); loopback,\n  link-local, site-local, unique-local, Teredo, discard-only, 6to4, NAT64,\n  IPv4-compatible, and multicast (all IPv6); or IPv4-mapped IPv6 (automatically\n  unwrapped to check the embedded IPv4).\n- Every redirect hop is re-validated the same way — not just the initial URL —\n  since a public hostname can redirect to a private address.\n- The response body is size-checked while streaming, so an oversized response is\n  aborted mid-transfer rather than after it's already been downloaded.\n- A hard timeout (`fetchTimeoutMs`, overridable per call) aborts a slow or\n  hanging response.\n- The destination path is deny-path- and collision-checked *before* any network\n  call, so a denied or already-occupied path never causes an outbound request.\n\n`maxBytes` and `timeoutMs` can be overridden per call; otherwise they default to\nthe config file's `fetchMaxBytes`/`fetchTimeoutMs`.\n\n---\n\n### read-file\n\n`read-file` returns an existing binary file (a PDF, say) to the client as\ntwo content blocks: a text line\n(`attachments/report.pdf (48213 bytes, application/pdf)`) and an MCP embedded\n`resource` carrying the base64 bytes and the file's `mimeType`.\n\n```text\nread-file → { filename: \"report.pdf\", folder: \"attachments\" }\n```\n\nThe server never parses a PDF, extracts text, renders pages or runs OCR, so it\nneeds no extra software; the client does the reading, which is why one tool\ncovers a PDF with a real text layer and a scanned PDF whose text is only in\nimages. In Claude Code the bytes are saved to a file and the agent opens that\npath with its `Read` tool (checked end to end for both kinds of PDF). Claude\nDesktop chat shows images but silently drops a PDF and rejects other types, so\nuse a code mode chat there; other clients have not been checked. The\n`skills/read-file` skill makes an agent check this first. A `.md`\nnote is returned too, as its raw bytes (`text/markdown`), but `read-note` is\nbetter for a note. A file larger than\n`readMaxBytes` (10 MiB by default) is refused before it is read.\n\n### upload-file\n\n`create-file` needs the model to write the whole file out as base64,\nwhich is impractical beyond a few tens of kilobytes (an 810 KB PDF is about a\nmillion tokens) and gives no way to check the file arrived intact.\n`upload-file` reserves a one-time URL that the agent sends the file to\ndirectly, so its bytes never pass through the model:\n\n```text\nupload-file → { filename: \"report.pdf\", folder: \"attachments\", size: 810490, sha256: \"<64 hex characters>\" }\ncurl --fail-with-body -sS -T report.pdf \"https://server:4001/up/<random token>\"\n```\n\nThe size and SHA-256 come from a tool (`wc -c`, `sha256sum`), never from the\nmodel. The URL is the config's `mcpBaseUrl` (scheme, host and port, no path or\ntrailing slash), then `/up/`, then a random token. The server checks the\nreceived bytes against the declared size and hash and places the file only if\nboth match; otherwise it discards it.\n\n- The URL works for **one request only**: the first request that names it uses\n  it up, whatever that request is. If anything goes wrong, request a new URL.\n- It works from any address by default, and lasts `uploadTtlSeconds` (300 by\n  default). `uploadNetworkPrefix` can require the same address as the call that\n  reserved it (32) or the same network (16 to 31). The server logs the reason\n  for every refusal.\n- The destination must not exist, and `denyPaths` is checked when the URL is\n  reserved and again when the file is placed.\n- A note (`.md`) can be uploaded too, for a large or generated file that is\n  already on disk. It is placed only if it is valid UTF-8; otherwise the upload\n  is refused with `400` and nothing is written. Use `create-note` for text the\n  agent has written itself.\n- At most `uploadMaxBytes` (50 MiB by default), 16 pending URLs and 4 uploads at\n  once.\n- The file is held in `uploadTempDir` until verified, never inside a vault. At\n  startup the server refuses a staging folder owned by another user, and\n  tightens one that others can access to owner-only.\n- Symbolic links in the destination are followed before the deny rules are\n  checked, so an upload can't be used to write outside the vault.\n- Behind a reverse proxy, set `trustedProxies` to the proxy's address (for\n  example `[\"127.0.0.1\", \"::1\"]`) so the address in the log and in\n  the `uploadNetworkPrefix` check is the real caller's, from `X-Forwarded-For`.\n  The header is ignored from any other connection. Without it every caller looks\n  like the proxy, and a hint is logged once.\n\nIt needs an agent with a shell on a machine that can reach the server's address,\nsuch as Claude Code. The token limits one upload to one destination but is not\nauthentication: anyone who can call the server's tools can reserve a URL, and\nthe URL is visible in the conversation, which is why it is short-lived and\nsingle-use. `curl` exits with code 22 and prints the server's explanation on any\nfailure: `403` an `Origin` header (or a wrong address, when\n`uploadNetworkPrefix` is set), `404` unknown, used or expired URL, `409`\ndestination appeared meanwhile, `411` no `Content-Length`, `413` or `400` size\nmismatch, `422` hash mismatch, `503` too many uploads at once.\n\n### replace-file\n\n`upload-file` never overwrites. `replace-file` replaces a file that\nis already in the vault, with the same one-time URL and `curl` upload, but only\nif the file is still the version the caller read. Both `expectedSha256` and\n`expectedMtime` are required, and they come from the `sha256:` and\n`Last-Modified:` lines of `read-file`:\n\n```text\nreplace-file → { filename: \"report.pdf\", folder: \"attachments\", size: 912340, sha256: \"<new file>\", expectedSha256: \"<file in the vault>\", expectedMtime: \"2026-05-01T09:30:00.123Z\" }\n```\n\n- The two values are checked when the URL is reserved and again when the file\n  arrives, so a file that someone changed in between is never overwritten\n  (`409`).\n- The old version moves to `.trash`; the new file is renamed over the\n  destination, so a complete file is always there.\n- The file must exist, a new file identical to it is refused, and a file under\n  `denyBinaryPaths` cannot be replaced.\n- Everything else, including the limits and the address rules, is as for\n  `upload-file`. The `replace-file` skill does the hashing and the\n  `curl` call.\n\n### Binary read protection (`denyBinaryPaths`)\n\n`denyPaths` removes a path from every tool; `denyBinaryPaths` only stops the\nagent reading a binary file's *contents* with `read-file`. The files stay\nvisible: the agent can still create, move and delete them, and `find-backlinks`\nstill sees them. Each entry is a vault-relative path with optional wildcards:\n\n- `*` matches any run of characters within one path segment, `?` matches one\n  character within a segment, and `**` as a whole segment matches any number of\n  segments, including none. Everything else is literal; matching is\n  case-sensitive.\n- An entry protects a path it matches and everything under a folder it matches.\n  `scans` protects `scans/a.pdf` and `scans/2026/b.pdf` but not\n  `scans-old/a.pdf`; `**/*.pdf` protects every PDF in the vault; `*/scans`\n  protects `a/scans/x.pdf`.\n\nAs with `denyPaths`, the top-level list applies to every vault and a vault's own\nlist is added on top. A refused read returns\n`Reading is restricted for '<path>'`. `move-file` (and `move-note`, for a\nnon-`.md` file) refuses to move a protected file to a path that is not protected\n(judged by the destination's final path, so renaming `scan.pdf` to `scan.txt`\nunder `**/*.pdf` is refused too); moving within the protected area, or moving an\nunprotected file in, is allowed.\n\nTo keep the protection from being sidestepped, `.trash` is protected\nautomatically whenever any `denyBinaryPaths` are set (a non-permanent delete\nmoves a file there), `read-note` refuses a protected non-`.md` file, and\n`read-file` resolves symbolic links and checks the real location,\nrefusing a link that points outside the vault. The other tools judge a path as\ngiven and don't resolve symlinks, so don't put symlinks to sensitive files in a\nserved vault.\n\n## Connecting Claude Code\n\nAdd the server to your Claude Code config (`~/.claude.json` or via\n`claude mcp add`):\n\n```json\n{\n  \"mcpServers\": {\n    \"obsidian\": {\n      \"type\": \"http\",\n      \"url\": \"https://your-hostname:4001/mcp\"\n    }\n  }\n}\n```\n\nClaude Code will prompt you to authenticate the first time — click through the\nOAuth flow (it uses a public/no-credentials token, so no real account is\nneeded).\n\n---\n\n## Connecting Claude Desktop\n\nUnlike Claude Code, Claude Desktop doesn't speak the MCP Streamable HTTP\ntransport directly — it only launches local stdio subprocesses. To reach a\nremote server like this one, it needs a small relay in between that translates\nits stdio JSON-RPC traffic into HTTP+SSE calls against the server's `/mcp`\nendpoint. Two options:\n\n- **[`mcp-remote`](https://www.npmjs.com/package/mcp-remote) via `npx`** (below)\n  — the quickest option, no install or local files needed, good for a plain\n  no-credentials setup like this server's public OAuth flow.\n- **[`mcp-shim`](https://github.com/a1ecbr0wn/obsidian-mcp-brain#mcp-shim)** — a\n  zero-dependency local script from this project's repo, worth using instead if\n  you need a bearer token, a custom request timeout, or want to avoid an `npx`\n  download on every Claude Desktop launch.\n\nEdit `claude_desktop_config.json` (find it via **Claude Desktop → Settings →\nDeveloper → Edit Config**) and add an entry under `mcpServers`, replacing the\nURL below with your server's actual address:\n\n```json\n{\n  \"mcpServers\": {\n    \"obsidian\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote@latest\",\n        \"https://your-hostname:4001/mcp\"\n      ]\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving.\n\n---\n\n---\n\n## Agent skills and agents\n\nThe repository includes three agent skills, `read-file`,\n`upload-file` and `replace-file`, in\n[`skills/`](https://github.com/a1ecbr0wn/obsidian-mcp-brain/tree/main/skills).\nThe tools work without them; the skills tell an agent how to use the tools well\nand what to say when a client can't show a file. The server tells a connected\nagent about them: the `get-setup-status` tool lists the skills and agents and\nhow to install them, and a plugin can carry agents as well as skills.\nThe tools used to be called `*-binary-file`; the old names no longer exist, so\nreinstall the plugin and rewrite any permission rule for `upload-binary-file.sh`\nas one for `upload-file.sh`.\n\n| Where you run Claude | How to get the skills |\n| --- | --- |\n| Claude Code, including the code mode of the Claude Desktop app | `/plugin marketplace add a1ecbr0wn/obsidian-mcp-brain`, then `/plugin install obsidian-mcp-brain@obsidian-mcp-brain` |\n| Cowork, Claude Desktop chat and claude.ai | Upload the `obsidian-mcp-brain.plugin` file from the [latest release](https://github.com/a1ecbr0wn/obsidian-mcp-brain/releases/latest) at **Customize → Plugins → Add → Upload plugin** |\n| One skill on Claude Desktop chat or claude.ai | Upload its `.skill` file from the latest release in **Settings → Capabilities → Skills** |\n\n---\n\n## Available Tools\n\n| Tool | Description |\n| --- | --- |\n| `list-notes` | List the notes (`.md` files) in the vault, or scoped to a folder. For other files use `list-files`. Returns sorted vault-relative paths, each with a last-modified timestamp |\n| `list-files` | List every file in the vault, or scoped to a folder, whatever its type (scripts, PDFs, images, notes), optionally narrowed by `extension`. Returns sorted vault-relative paths, each with a last-modified timestamp and the size in bytes |\n| `list-tags` | List all unique tags (YAML frontmatter) used across vault notes, optionally scoped to a subdirectory |\n| `search-tags` | Find notes that have ALL of the specified tags |\n| `new-notes` | List notes created in the last 7 days, or since a provided timestamp |\n| `changed-notes` | List notes modified in the last 7 days, or since a provided timestamp |\n| `list-vaults` | List all configured vaults |\n| `get-setup-status` | List the companion skills and agents, the server version, and how to install them on each Claude surface |\n| `read-note` | Read a note's content and last-modified timestamp |\n| `create-note` | Create a new note. Fails if it already exists |\n| `edit-note` | Edit a note: append, prepend, replace, replace/delete the content under a heading, or toggle a checkbox |\n| `delete-note` | Delete a note, moving it to `.trash` by default |\n| `move-note` | Move or rename a note, rewriting all vault-wide wikilinks to the old path |\n| `create-file` | Create a new file of any type (an image, a PDF, a `.md` note) from base64-encoded content. Fails if it already exists |\n| `fetch-file` | Create a new file of any type by downloading a URL server-side, so the client only sends a URL, not the file content |\n| `upload-file` | Reserve a one-time upload URL for a file of a declared size and SHA-256; the agent sends the file to it with `curl`, so its bytes never pass through the model |\n| `replace-file` | Reserve a one-time upload URL that replaces a file already in the vault, only if it is still the version named by its SHA-256 and mtime; the old version moves to `.trash` |\n| `read-file` | Return an existing file of any type (e.g. a PDF) to the client as an embedded base64 resource, so the agent can read it |\n| `move-file` | Move or rename a file of any type, rewriting the wikilinks (for a note) or embeds (for any other file) that point at the old path |\n| `delete-file` | Delete a file of any type, a `.md` note included, moving it to `.trash` by default |\n| `find-backlinks` | Find all notes that link to or embed a given note or binary file |\n| `resolve-wikilink` | Resolve a wikilink target string to the vault-relative file(s) it points to |\n| `create-folder` | Create a new folder (and any missing parents) in the vault |\n| `search-vault` | Search vault notes by content, filename, or both |\n| `add-tags` | Add tags to notes in frontmatter and/or inline body content |\n| `remove-tags` | Remove tags from notes in frontmatter and/or inline body content |\n| `rename-tag` | Rename a tag throughout the entire vault (frontmatter and inline) |\n| `set-frontmatter-field` | Set a single frontmatter field (not `tags`) to a scalar value, creating it if missing |\n| `remove-frontmatter-field` | Remove a single frontmatter field (not `tags`) entirely |\n| `query-graph` | Ask a natural-language question against a vault's graphify knowledge graph |\n\n---\n\n## How obsidian-mcp-brain works\n\nThe server implements the [MCP Streamable HTTP transport](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#streamable-http)\nand answers protocol versions 2025-06-18, 2025-03-26 and 2024-11-05: `initialize`\nreturns the version the client asks for if the server speaks it, and the newest\notherwise, and a request whose `MCP-Protocol-Version` header names another\nversion is refused with `400`. A request carries one JSON-RPC message; a batch\n(an array) is refused with `400`.\n\n- **`POST /mcp`** — receives JSON-RPC requests from the client. `initialize`\n  creates a session and returns server capabilities. Notifications return 202\n  code. All other requests are dispatched to the corresponding tool handler and\n  the response is returned as an inline SSE event.\n\n- **`GET /mcp`** — keeps a long-lived SSE stream open per session for\n  server-to-client notifications. The server declares no `listChanged`\n  capability and sends none today; the stream is kept so that clients which\n  open it (and shims that reconnect it) work.\n\n- **`DELETE /mcp`** — ends the session named by `Mcp-Session-Id` and its\n  stream, and answers `204`. An unknown or missing session answers `404`. A\n  session that has been idle for `sessionTimeoutSeconds` is removed without it.\n\nAll MCP tools are implemented natively in the server and operate directly on\nvault files via `node:fs/promises`. Each tool resolves its `vault` argument\nagainst the configured vaults and validates access control (that vault's\neffective deny list) before executing.\n\n`resources/list` and `prompts/list` return empty results — the server does not\nexpose vault files as resources or prompts, only as tools.\n\n---\n\n## Security\n\nThe OAuth flow is intentionally public — there are no real credentials. Access\ncontrol relies on the network layer, so run the server on a private network, or\nan overlay network such as Tailscale, not on the public internet. The config\nfile's `denyPaths` feature provides coarse-grained control over which parts of a\nvault the MCP client can touch, but it is not a substitute for network-level\naccess control.\n","readmeFilename":"README.md"}