Obsidian Notes

Obsidian Notes

MCP server for Obsidian that provides secure, direct file system access to vault files.

6
Stars
0
Forks
0
Releases

Overview

Obsidian MCP Server is a direct-file-system MCP implementation for Obsidian vaults. It provides secure, on-disk access to vault files without requiring the Obsidian application, enabling compatibility with setups using obsidian.nvim and other integrations that offer Obsidian-like features. By operating directly on vault files on disk, it supports workflows where the Obsidian app is unavailable while delivering MCP-style discovery and navigation. The server exposes MCP resources via HATEOAS-style links, so search and list results include resource URIs that allow direct note access without extra queries. Security is a core design principle: inputs are validated against JSON schemas, path traversal is prevented, configurable file size limits are enforced, and content is sanitized to remove potentially harmful bytes. It also provides metadata support by parsing YAML frontmatter and inline tags. The search experience is feature-rich, with regex support, tag-based queries, context snippets, and optional highlighting. Recent updates introduce MOC discovery (discover-mocs) to map Maps of Content and relationships, and improvements to results structure, including grouping by file and showing match counts.

Details

Owner
Piotr1215
Language
JavaScript
License
Updated
2025-12-07

Features

Direct file system access to Obsidian vaults

Provides direct access to vault files on disk with no Obsidian app required, enabling usage with obsidian.nvim and similar setups.

Security-first design

Path traversal prevention and input validation to safeguard vault access and ensure safe operation.

High performance

Execution time tracking and configurable resource limits to maintain responsive operation.

Rich search capabilities

Supports regex, tag-based searches, and advanced query options for powerful content discovery.

Metadata support

Parses frontmatter and inline tags, enabling rich metadata extraction and queries.

MCP Resources (HATEOAS)

Automatic resource links and MCP resource URIs enable direct note access and navigable results.

MOC Discovery (discover-mocs)

New tool to discover Maps of Content and their relationships, providing a high-level vault knowledge map for faster navigation.

Enhanced search results

Contextual snippets, bold match highlighting, and file-grouped results with match counts for clearer review.

Audience

DevelopersBuild tooling and automation around Obsidian vaults with direct file access, without requiring the Obsidian app.
Power usersUtilize fast, searchable access to vault data and MOC maps to accelerate knowledge exploration.
Neovim/obsidian.nvim usersLeverage Obsidian-like features without the app, integrating vault access into Neovim workflows.

Tags

ObsidianMCPDirect File System AccessVaultSearchMOCobsidian.nvimHATEOAS