Obsidian MCP

by takuya0206

Integrations

  • 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)

  1. Clone this repository
  2. Install dependencies:
    npm install
  3. Build the project:
    npm run build
  4. Configure Claude Desktop App to use this MCP server:
    { "mcpServers": { "Obsidian": { "command": "node", "args": ["/Users/<Your Own Path>/obsisian-mcp/build/index.js"], "env": { "apiKey": "<Your API Token>", "port": "27123", "host": "127.0.0.1" } } } }

Development

Create .env and configure "apiKey", "port", and "host" as mentioned above.

Available Tools

The following tools are implemented:

  1. readNote - Read the contents of a specific note
    { "path": "path/to/note.md" }
  2. readActiveNote - Read the contents of the current active note
    {}
  3. listNotes - Recursively lists files and folders in the entire Vault or under a specified folder
    { "path": "optional/folder/path" }
  4. patchNote - Inserts content into an existing note relative to a heading, block reference, or frontmatter field
    { "path": "path/to/note.md", "operation": "append|prepend|replace", "targetType": "heading|block|frontmatter", "target": "target_identifier", "content": "content to insert" }
  5. searchWithJsonLogic - Search Obsidian notes using JsonLogic format queries
    { "query": { // JsonLogic query object } }
-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. Prerequisites
    1. Setting MCP Server (e.g. Claude Desktop App)
      1. Development
        1. Available Tools

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        Enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.
        Last updated -
        598
        149
        TypeScript
        MIT License
        • Apple
      • -
        security
        F
        license
        -
        quality
        This 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 -
        598
        7
        JavaScript
      • A
        security
        A
        license
        A
        quality
        A 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 -
        12
        40
        20
        TypeScript
        MIT License
      • A
        security
        A
        license
        A
        quality
        A 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 -
        25
        1
        Python
        MIT License

      View all related MCP servers

      ID: lnk85kbz4o