Piotr1215/mcp-obsidian
View on GitHub ↗simple mcp server for interacting with local obsidian notes
23 ★10 forksJavaScriptUpdated 6mo ago
What you need to know
An MCP server for Obsidian that provides secure, direct file system access to vault files without requiring the Obsidian app or REST API plugin, with search, read/write/delete, tags, metadata and MOC discovery.
Install
git clone https://github.com/Piotr1215/mcp-obsidian && cd mcp-obsidian && npm install claude mcp add obsidian -s user -- node /path/to/src/index.js /path/to/your/vault
Usage
- •search-vault with boolean operators, field specifiers and context snippets
- •discover-mocs to map your vault's structure via Maps of Content
Key features
- ✓Direct vault file access, no Obsidian app required
- ✓Boolean/tag/title search with context snippets and highlight
- ✓Read, write, delete notes; get-note-metadata
- ✓MOC (Map of Content) discovery
- ✓Security-first design with path traversal prevention
Best for
Obsidian users and obsidian.nvim setups who want agent access to their vault
Caveats
- ⚠Only .md files are accessible
- ⚠Vault path is passed on the command line at server start
Platforms: macOS · Windows · LinuxClients: Claude Code · Claude Desktop
Reviewed 2026-08-11
Topics
ai-toolsclaude-desktopknowledge-managementmcp-servermodel-context-protocolnote-takingobsidianobsidian-mdpkmsecond-brain
- Stars
- 23★
- Forks
- 10
- Language
- JavaScript
- License
- —
- Created
- 2025-06-19
- Last push
- 2026-02-14