obsidian-mcp
Provides tools to manage an Obsidian vault, including reading, creating, editing, searching, moving, and deleting notes, managing tags and directories, and recovering from trash.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@obsidian-mcpcreate a new note called 'Meeting Notes' with content 'Discussed project timeline.'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
obsidian-mcp
Single-container MCP server for an Obsidian vault. Handles authentication, CORS, SSE streaming, and exposes 14 vault-management tools — no nginx or supergateway needed.
Quick start
docker run -d --name mcp \
-p 127.0.0.1:3000:3000 \
-v /path/to/your/vault:/vault \
-e VAULT_PATH=/vault/Obsidian\ Vault \
ghcr.io/lpfchan/mcpOr with docker-compose:
services:
mcp:
build: .
container_name: mcp
ports:
- 127.0.0.1:3000:3000
environment:
- VAULT_PATH=/vault/Obsidian Vault
volumes:
- ./vault:/vaultConfiguration
Variable | Default | Description |
| (required) | Path to the Obsidian vault inside the container |
|
| API token for Bearer or URL-path auth |
|
| HTTP listen port |
|
| CORS allowed origin |
|
| Bind address |
Authentication supports both Authorization: Bearer <token> headers and URL-path tokens (/<token>/mcp).
Tools
Tool | Description |
| Lists available vault names |
| Reads a note's content |
| Creates a new note |
| Edits a note (append, prepend, overwrite, or targeted replace) |
| Searches content, filenames, or tags (with fuzzy mode) |
| Lists all |
| Moves or renames a note |
| Creates a directory in the vault |
| Moves a note to |
| Adds tags to frontmatter |
| Removes tags from frontmatter |
| Renames a tag across all notes |
| Permanently deletes a directory |
| Lists files in |
| Recovers a file from |
Testing
npm install
npm test59 tests across 18 suites covering every tool, auth, CORS, and edge cases.
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
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/LPFchan/mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server