oleksandrkucherenko avatar

Obsidian Vault MCP Server

oleksandrkucherenko/mcp-obsidian-via-rest

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 tools

Public 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*secret

Obsidian Local REST API key

API_URLS*

JSON array or semicolon-separated list of Obsidian REST API URLs for failover

API_HOST

Obsidian REST API host (legacy single-URL config)

API_PORT

Obsidian REST API port (legacy single-URL config)

MCP_TRANSPORTSdefault: stdio,http

Enabled transports (default: stdio,http)

MCP_HTTP_PORTdefault: 3000

HTTP transport bind port (default: 3000)

MCP_HTTP_HOST

HTTP transport bind host (default: 0.0.0.0)

MCP_HTTP_TOKENsecret

Bearer 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

Related Documents & Knowledge MCP servers

View all
1aryanbv avatarPdf Toolkit Mcparyanbv/pdf-toolkit-mcpWrite-capable PDF toolkit MCP: 22 tools to read, create, render, encrypt, merge & fill PDFs.7stars
2sunub avatarSunub Obsidian Mcp Serversunub/obsidian-mcp-serverSearch your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…2stars
3us-all avatarGoogle Driveus-all/google-drive-mcp-serverGoogle Drive + Workspace MCP — Docs, Sheets, Slides, Shared Drives, Labels, Approvals, DWD1stars
4mcp-z avatarMcp Pdfmcp-z/mcp-pdfMCP server for PDF generation using PDFKit1stars
5r09722akabennett avatarNanoPDFr09722akabennett/nano-pdf-mcpAI-powered PDF editing and generation MCP server using Gemini Pro.1stars
6filegraph avatarDocument Processingfilegraph/docconvertExtract text from documents, manipulate PDFs, and perform OCR on images.0stars