obsidian-mcp
by JasonSooter
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| QUARTZ_ENABLED | No | Turn on the Quartz publishing tools. | false |
| OBSIDIAN_VAULTS | Yes | Required. Comma-separated vault folder names under OBSIDIAN_VAULT_ROOT. | |
| OBSIDIAN_MCP_ENV | No | deployment.environment.name on telemetry. | production |
| QUARTZ_REPO_PATH | No | Checkout of your Quartz site repo. | /quartz |
| OBSIDIAN_MCP_HOST | No | Listen address. | 0.0.0.0 |
| OBSIDIAN_MCP_PORT | No | Listen port. | 8780 |
| QUARTZ_GIT_AUTHOR | No | Commit author for publishes. | obsidian-mcp <obsidian-mcp@localhost> |
| QUARTZ_GIT_BRANCH | No | Where publishing pushes. | main |
| QUARTZ_GIT_REMOTE | No | Where publishing pushes. | origin |
| OBSIDIAN_VAULT_ROOT | No | Directory holding the vault folders. | /vaults |
| QUARTZ_SSH_KEY_PATH | No | Deploy key used to push the site repo. | |
| QUARTZ_BUILD_LOCALLY | No | Run 'npx quartz build' before pushing. The image has no Node, so set 'false' when your host builds on push. | true |
| OBSIDIAN_DEFAULT_VAULT | No | Vault used when a tool call names none. | first of OBSIDIAN_VAULTS |
| OBSIDIAN_MCP_STATE_DIR | No | Version journal, OAuth database, audit log. | /state |
| OBSIDIAN_MAX_FILE_BYTES | No | Files larger than this are refused. | 2000000 |
| OBSIDIAN_MCP_PUBLIC_URL | No | The public base URL clients reach. Becomes the OAuth issuer: set it exactly. | http://localhost:<port> |
| OBSIDIAN_MCP_TOTP_SECRET | Yes | Required. Base32 TOTP secret (the setup key, not a 6-digit code). | |
| OTEL_EXPORTER_OTLP_HEADERS | No | Optional OTLP log export headers, e.g. Authorization headers. Unset = log to stdout only. | |
| OBSIDIAN_MCP_LOGIN_PASSWORD | Yes | Required. Login password, at least 12 characters. | |
| OTEL_EXPORTER_OTLP_ENDPOINT | No | Optional OTLP log export endpoint. Unset = log to stdout only. | |
| OBSIDIAN_JOURNAL_RETENTION_DAYS | No | Full undo history kept this long, then thinned to daily. | 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 | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessUnresponsive