
Obsidian Vault MCP Server
Bridges Claude to your Obsidian vaults through the Local REST API plugin. Exposes three tools: get_note_content for retrieving individual notes with metadata, obsidian_search for text queries, and obsidian_semantic_search for meaning-based lookups. Also provides a resource handler for obsidian:// URIs. The multi-URL configuration is the standout feature here: it tests all your endpoints in parallel, picks the fastest, and automatically fails over if a connection drops. That's especially useful in WSL2 or Docker setups where localhost, host.docker.internal, and gateway IPs might all be valid but with different latency. Ships with both stdio and HTTP transports, and includes Docker images if you want to run it containerized.
- GitHub stars
- 13
- tools
- 3
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 8
- last updated
- Jan 18, 2026
Tools
3 toolsPublic tool metadata for what this MCP can expose to an agent.
get_note_contentRetrieve content and metadata of an Obsidian note
Retrieve content and metadata of an Obsidian note
No parameter schema in public metadata yet.
obsidian_searchSearch notes using a query string
Search notes using a query string
No parameter schema in public metadata yet.
obsidian_semantic_searchSemantic search for notes
Semantic search for notes
No parameter schema in public metadata yet.
Sponsors
Configuration
API_KEY*secretObsidian Local REST API key
API_URLS*JSON array or semicolon-separated list of Obsidian REST API URLs for failover
API_HOSTObsidian REST API host (legacy single-URL config)
API_PORTObsidian REST API port (legacy single-URL config)
MCP_TRANSPORTSdefault: stdio,httpEnabled transports (default: stdio,http)
MCP_HTTP_PORTdefault: 3000HTTP transport bind port (default: 3000)
MCP_HTTP_HOSTHTTP transport bind host (default: 0.0.0.0)
MCP_HTTP_TOKENsecretBearer token for HTTP transport authentication
Readme
Details
- Repository
- github.com/oleksandrkucherenko/mcp-obsidian-via-rest
- Website
- github.com/OleksandrKucherenko/mcp-obsidian-via-rest#readme
- Categories
- Documents & Knowledge, Search & Web Crawling
- Package
@oleksandrkucherenko/mcp-obsidian- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active