Schema | obsidian-mcp-server

obsidian-mcp-server

Overview Schema Related Servers Score Discussions

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`OBSIDIAN_IGNORE`	No	Comma-separated list of file/directory names to skip during traversal. Match is by name (not glob). Whitespace is trimmed; empty entries are discarded. Values fully replace defaults, so repeat the defaults you want to keep. Precedence: CLI flag --ignore overrides this environment variable.	.obsidian,.git,node_modules,.DS_Store,.trash
`OBSIDIAN_PRETTY`	No	Enables pretty JSON output. Accepts any value Go's strconv.ParseBool accepts: 1, t, T, true, TRUE, True, 0, f, F, false, FALSE, False. Anything else causes a startup error. Precedence: CLI flag --pretty overrides this environment variable.	false
`OBSIDIAN_CLIENT_CA`	No	Path to a PEM file of trusted client CAs for --transport http. Enables mandatory mutual TLS — connections without a valid client certificate are rejected. Precedence: CLI flag --client-ca overrides this environment variable.
`OBSIDIAN_HTTP_BIND`	No	Bind address for --transport http. Non-loopback addresses are refused unless OBSIDIAN_ALLOW_NON_LOOPBACK is also set. Precedence: CLI flag --http-bind overrides this environment variable.	127.0.0.1
`OBSIDIAN_HTTP_PORT`	No	Port for --transport http. Precedence: CLI flag --http-port overrides this environment variable.	8443
`OBSIDIAN_LOG_LEVEL`	No	One of: debug, info, warn, error (lowercase, case-sensitive). Unknown values silently fall back to warn. Precedence: CLI flag --log-level overrides this environment variable.	warn
`OBSIDIAN_MAX_BATCH`	No	Integer >= 1. Caps the number of files processed in a single batch tool call (e.g. read_multiple_notes). Non-integer or <1 causes a startup error. Precedence: CLI flag --max-batch overrides this environment variable.	10
`OBSIDIAN_READ_ONLY`	No	When enabled, mutating tools (write_note, delete_note, move_note, etc.) are not registered. Accepts the same ParseBool values as OBSIDIAN_PRETTY. Precedence: CLI flag --read-only overrides this environment variable.	false
`OBSIDIAN_TRANSPORT`	No	Transport mode for the server: 'stdio' or 'http'. http starts a TLS-secured Streamable HTTP listener instead of speaking MCP over stdio. Precedence: CLI flag --transport overrides this environment variable.	stdio
`OBSIDIAN_EXTENSIONS`	No	Comma-separated list of file extensions to make visible to MCP tools. Each entry should start with a dot (e.g. .md). Whitespace is trimmed and empty entries are discarded. Precedence: CLI flag --extensions overrides this environment variable.	.md,.markdown,.txt,.canvas
`OBSIDIAN_VAULT_NAME`	No	Used to build obsidian://open deep links. Defaults to the vault directory's basename. Set explicitly if the vault directory's name doesn't match the name Obsidian shows for it. Precedence: CLI flag --vault-name overrides this environment variable.
`OBSIDIAN_VAULT_PATH`	Yes	The path to the Obsidian vault directory. This is required and validated at startup. Precedence: CLI flag --vault overrides this environment variable.
`OBSIDIAN_MAX_RESULTS`	No	Integer >= 1. Caps the number of search results returned by search_notes and search_regex. Non-integer or <1 causes a startup error. Precedence: CLI flag --max-results overrides this environment variable.	20
`OBSIDIAN_ALLOWED_HOSTS`	No	Comma-separated Host header allowlist for --transport http. Required when OBSIDIAN_ALLOW_NON_LOOPBACK is true. Precedence: CLI flag --allowed-hosts overrides this environment variable.
`OBSIDIAN_ALLOWED_ORIGINS`	No	Comma-separated Origin header allowlist for --transport http. Required when OBSIDIAN_ALLOW_NON_LOOPBACK is true. Precedence: CLI flag --allowed-origins overrides this environment variable.
`OBSIDIAN_ALLOW_NON_LOOPBACK`	No	Allows --http-bind to use a non-loopback address. Requires non-empty OBSIDIAN_ALLOWED_HOSTS and OBSIDIAN_ALLOWED_ORIGINS — an explicit, three-flag confirmation gate. Accepts ParseBool values. Precedence: CLI flag --allow-non-loopback overrides this environment variable.	false
`OBSIDIAN_TRASH_RETENTION_DAYS`	No	Integer >= 0. delete_note moves notes to .obsidian-mcp/trash by default; entries older than this many days are pruned once at startup. Non-integer or negative causes a startup error. Precedence: CLI flag --trash-retention-days overrides this environment variable.	30

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

Name	Description
No tools

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

Server Configuration
Instructions
Capabilities
Tools
Prompts
Resources

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tylern91/obsidian-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server