MCPSERV.CLUB
yokarilight

Obsidian MCP Lite

MCP Server

Lightweight MCP server for Obsidian vaults

Stale(55)
1stars
3views
Updated May 9, 2025

About

A TypeScript-based MCP server that provides a simple interface to interact with Obsidian vaults, enabling file listing, content retrieval, search, patching, appending and deletion via the Local REST API.

Capabilities

Resources
Access data sources
Tools
Execute functions
Prompts
Pre-built templates
Sampling
AI model interactions

Overview

The Obsidian MCP Lite server bridges the gap between AI assistants and personal knowledge bases built in Obsidian. By exposing a lightweight TypeScript‑based MCP interface, it allows assistants such as Claude to treat an Obsidian vault like a first‑class data source. This solves the long‑standing problem of how to let an AI read, write, and search a local vault without exposing the entire file system.

At its core, the server translates MCP calls into requests against Obsidian’s Local REST API. Developers can list every file, drill down into a directory, retrieve or modify content, and perform text searches—all through standard MCP resources. The ability to patch, append, or delete files means an AI can not only pull knowledge but also update it in place. For example, a note‑taking workflow could let an assistant auto‑summarize meeting transcripts and append the summary directly into a project folder, or delete outdated reference files after migration.

Key capabilities include:

  • File enumeration: Quickly discover all vault contents or target a specific folder.
  • Content access: Read full file bodies with simple GET requests, enabling context‑aware responses.
  • Search: Locate exact text snippets across the vault, useful for fact‑checking or finding related concepts.
  • Mutation: Patch existing text (e.g., inserting a new heading), append new content, or remove obsolete files—all through secure MCP calls.
  • Security: Operates over an API key, ensuring that only authorized AI agents can interact with the vault.

Real‑world use cases span from academic research—where an assistant pulls citations and updates literature reviews—to personal productivity, where it can automatically tag notes, generate daily summaries, or archive completed tasks. In collaborative settings, the server lets multiple assistants work concurrently on shared vaults while maintaining auditability through the underlying REST API.

Integrating Obsidian MCP Lite into an AI workflow is straightforward: add the server to the client’s configuration, and expose its resources as tools. The assistant can then invoke these tools in natural language prompts, seamlessly blending human intent with programmatic vault manipulation. Because it relies on the proven Obsidian Local REST API, developers benefit from a stable, well‑documented backend while keeping the MCP layer lightweight and focused on interaction.

In summary, Obsidian MCP Lite empowers AI assistants to treat local knowledge bases as dynamic, queryable resources. Its minimalistic yet powerful set of file operations, combined with secure authentication and native integration with Obsidian, makes it a standout choice for developers seeking to embed AI into their personal or team‑based note ecosystems.