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:/vaultRelated MCP server: obsidian-mcp-complete
Configuration
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
Maintenance
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
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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