obsidian-mcp

obsidian-mcp

23
knowledge_and_memoryfile_systems

The Obsidian MCP Server connects AI models to the Obsidian knowledge base, allowing for interaction with notes and folder structures. Key features include note management and full-text search. The server complies with Model Context Protocol specifications and integrates with Obsidian via the Local REST API plugin.

Obsidian MCP Server

This project implements a Model Context Protocol (MCP) server that connects AI models with the Obsidian knowledge base. Key features include seamless integration with the Obsidian knowledge base, support for reading, creating, updating, and deleting notes, managing folder structures, and full-text search functionality. The project adheres to the Model Context Protocol specifications.

Features

  • Seamless integration with Obsidian
  • Read, create, update, delete notes
  • Manage folders: create, rename, move, delete
  • Full-text search

Prerequisites

  • Node.js (v16 or higher)
  • Obsidian desktop app
  • Obsidian Local REST API plugin

Usage

Direct Usage

  1. Ensure Obsidian is running with the configured Local REST API plugin.
  2. Start the MCP server.

Docker Deployment

Using Docker Compose
  1. Ensure Docker and Docker Compose are installed.
  2. Configure environment variables and start the container.
Using Docker Commands
  1. Build and run the Docker container.

Supported Tools

  • list_notes: List all notes
  • read_note: Read note content
  • create_note: Create a new note
  • update_note: Update existing note
  • search_vault: Search content
  • delete_note: Delete note
  • manage_folder: Manage folders