Provides tools for interacting with Obsidian vaults, including reading notes, accessing the active note, listing files and folders, modifying notes with targeted insertions, and searching notes using JsonLogic queries.
Obsidian MCP (Model Context Protocol)
Obsidian MCP is a tool that allows you to interact with your Obsidian vault using the Model Context Protocol. This enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.
Prerequisites
- Node.js 18 or higher
- Obsidian with Local REST API plugin installed and configured
- API key generated from the Local REST API plugin
Setting MCP Server (e.g. Claude Desktop App)
- Clone this repository
- Install dependencies:
- Build the project:
- Configure Claude Desktop App to use this MCP server:
Development
Create .env
and configure "apiKey", "port", and "host" as mentioned above.
Available Tools
The following tools are implemented:
- readNote - Read the contents of a specific note
- readActiveNote - Read the contents of the current active note
- listNotes - Recursively lists files and folders in the entire Vault or under a specified folder
- patchNote - Inserts content into an existing note relative to a heading, block reference, or frontmatter field
- searchWithJsonLogic - Search Obsidian notes using JsonLogic format queries
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Model Context Protocol server that enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.
Related MCP Servers
- -securityAlicense-qualityEnables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.Last updated -598149TypeScriptMIT License
- -securityFlicense-qualityThis project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.Last updated -5987JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with the HackMD API for managing notes, including creating, reading, updating, and deleting notes.Last updated -1212221TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.Last updated -2519PythonMIT License
Appeared in Searches
- Optimizing prompts for exploring and utilizing a local document library
- A lightweight MCP server for managing Markdown files without external dependencies
- Information on memory banks or task managers
- A tool for exploring local code repositories and identifying relevant files
- Understanding Project Context