obsidian-mcp-server
MCP server for Obsidian — read, write, search, and surgically edit notes, tags, and frontmatter.
Package Details
obsidian-mcp-server
Package Arguments
Positional
runstart:stdioEnvironment Variables
Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API).
http://127.0.0.1:27123Base URL of the Obsidian Local REST API. Default: http://127.0.0.1:27123 (enable "Non-encrypted (HTTP) Server" in plugin settings). Use https://127.0.0.1:27124 for the always-on HTTPS port (self-signed cert; pair with OBSIDIAN_VERIFY_SSL=false).
falseWhether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert.
30000Per-request timeout in milliseconds.
falseOpt-in flag for the command-palette pair (obsidian_list_commands + obsidian_execute_command). Off by default — Obsidian commands are opaque and can be destructive.
Optional comma-separated vault-relative folder allowlist for reads. Prefix-based with implicit recursion; case-insensitive; trailing slashes normalized. Unset = full vault. Write paths are implicitly readable. Example: 'public/,projects/'.
Optional comma-separated vault-relative folder allowlist for writes. Same syntax as OBSIDIAN_READ_PATHS. Unset = full vault. Example: 'projects/,scratch/'.
falseGlobal read-only kill switch. When true, every write is denied regardless of OBSIDIAN_WRITE_PATHS, and the command-palette pair is suppressed (commands can mutate). Useful for shared or public-facing deployments.
Override URL for the Omnisearch plugin HTTP server. Unset derives from OBSIDIAN_BASE_URL host with port 51361. Required only if the Omnisearch plugin is not on the default port.
infoSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
obsidian-mcp-server
Package Arguments
Positional
runstart:httpEnvironment Variables
Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API).
http://127.0.0.1:27123Base URL of the Obsidian Local REST API. Default: http://127.0.0.1:27123 (enable "Non-encrypted (HTTP) Server" in plugin settings). Use https://127.0.0.1:27124 for the always-on HTTPS port (self-signed cert; pair with OBSIDIAN_VERIFY_SSL=false).
falseWhether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert.
30000Per-request timeout in milliseconds.
falseOpt-in flag for the command-palette pair (obsidian_list_commands + obsidian_execute_command). Off by default — Obsidian commands are opaque and can be destructive.
Optional comma-separated vault-relative folder allowlist for reads. Prefix-based with implicit recursion; case-insensitive; trailing slashes normalized. Unset = full vault. Write paths are implicitly readable. Example: 'public/,projects/'.
Optional comma-separated vault-relative folder allowlist for writes. Same syntax as OBSIDIAN_READ_PATHS. Unset = full vault. Example: 'projects/,scratch/'.
falseGlobal read-only kill switch. When true, every write is denied regardless of OBSIDIAN_WRITE_PATHS, and the command-palette pair is suppressed (commands can mutate). Useful for shared or public-facing deployments.
Override URL for the Omnisearch plugin HTTP server. Unset derives from OBSIDIAN_BASE_URL host with port 51361. Required only if the Omnisearch plugin is not on the default port.
127.0.0.1The hostname for the HTTP server.
3010The port to run the HTTP server on.
/mcpThe endpoint path for the MCP server.
noneAuthentication mode to use: 'none', 'jwt', or 'oauth'.
infoSets the minimum log level for output (e.g., 'debug', 'info', 'warn').