Skip to main content
Glama
obsidian-local-mcp

obsidian-local-mcp

by chs2147

obsidian-local-mcp

로컬 디스크의 특정 디렉토리를 Obsidian Vault로 다루는 MCP 서버입니다. Claude(Desktop / Code)가 Vault 안에서 노트를 생성·읽기·수정하고 폴더를 읽고 생성할 수 있게 합니다. Claude가 만드는 모든 신규 노트에는 Obsidian Properties (YAML frontmatter)가 고정 순서로 기본 부여됩니다:

---
title:
aliases:
tags:
author:
date:
source:
type:
Service URL:
---

Vault 위치와 기본 author는 로컬 웹 설정 페이지(GUI) 에서 변경합니다.

구성 요소

항목

설명

MCP 서버 (dist/index.js)

7개 도구 제공 (아래)

설정 페이지 (npm run settings)

localhost 웹 UI — Vault 폴더 선택(네이티브 다이얼로그) + 기본 author

스킬 (skills/obsidian-vault)

Vault 연동 작업 규칙을 담은 Claude Skill

MCP 도구

  • create_note — 새 노트 생성(YAML 속성 자동 부여)

  • read_note — 노트 원문/frontmatter/본문 읽기

  • update_note — 본문(append/prepend/replace_body)·frontmatter 부분 수정

  • list_directory — 폴더 목록(recursive 옵션)

  • create_directory — 폴더 생성

  • search_notes — 파일명/본문/태그 검색

  • get_vault_info — Vault 경로·기본 author·노트 수 확인

Related MCP server: obsidian-mcp

설치

npm install
npm run build

1) Vault 지정 (GUI)

npm run settings

브라우저에 설정 페이지가 열립니다. ‘폴더 선택…’ 으로 macOS 폴더 다이얼로그를 띄워 Vault 폴더를 고르고(직접 입력도 가능), 기본 author를 입력한 뒤 저장합니다. 설정은 다음 위치에 저장되며, 실행 중인 MCP 서버에 다음 도구 호출부터 반영됩니다:

~/Library/Application Support/obsidian-local-mcp/config.json

참고: 설정 파일이 없으면 환경변수 OBSIDIAN_VAULT_PATH가 폴백으로 사용됩니다.

2) Claude에 등록

Claude Code (CLI)

claude mcp add obsidian -- node /ABSOLUTE/PATH/TO/obsidian-local-mcp/dist/index.js

또는 프로젝트 루트에 examples/mcp.json 내용을 참고해 .mcp.json을 둡니다.

스킬은 다음 중 한 곳에 복사합니다:

# 전역 사용
cp -r skills/obsidian-vault ~/.claude/skills/
# 또는 특정 프로젝트에서만
cp -r skills/obsidian-vault /your/project/.claude/skills/

Claude Desktop

claude_desktop_config.json에 다음을 추가합니다 (examples/claude_desktop_config.json 참고):

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/obsidian-local-mcp/dist/index.js"]
    }
  }
}

설정 파일 위치: ~/Library/Application Support/Claude/claude_desktop_config.json. 변경 후 Claude Desktop을 재시작합니다. 스킬은 Claude Desktop의 Skills(Capabilities) 설정에서 skills/obsidian-vault 폴더를 추가/활성화합니다.

동작 방식 / 안전성

  • 모든 경로는 Vault 루트 기준 상대경로만 허용합니다. 절대경로와 .. 탈출은 거부되어 Vault 밖 파일에 접근할 수 없습니다.

  • frontmatter는 항상 고정된 8개 키 순서로 직렬화됩니다(aliases/tags는 리스트, date는 Obsidian date 형식으로 비따옴표 출력).

  • .obsidian, .trash 등 점(.)으로 시작하는 항목은 목록/검색에서 제외됩니다.

검증 (MCP Inspector)

npx @modelcontextprotocol/inspector node dist/index.js

Inspector에서 get_vault_info → create_note → read_note → list_directory 순으로 호출해 동작을 확인할 수 있습니다.

Available Tools

7 tools
create_directory디렉토리 생성A

Vault 안에 폴더를 (재귀적으로) 생성한다.

Inputs: path (required).

create_note노트 생성A

Vault 안에 새 노트를 만든다. Obsidian YAML 속성(title, aliases, tags, author, date, source, type, Service URL)이 고정 순서로 기본 부여된다. 값을 채우려면 해당 파라미터를 넘기고, 비우면 빈 키만 유지된다.

Inputs: path (required), date, tags, type, +7 more.

get_vault_infoVault 정보A

현재 설정된 Vault 경로, 기본 author, 노트 수, config 파일 위치를 반환한다.

Inputs: no named parameters.

list_directory디렉토리 목록A

Vault 내 디렉토리의 파일/폴더 목록을 반환한다. (.으로 시작하는 항목 제외)

Inputs: path, recursive.

read_note노트 읽기A

Vault 내 노트의 원문, 파싱된 frontmatter, 본문을 반환한다.

Inputs: path (required).

search_notes노트 검색A

Vault 내 노트를 파일명/본문/태그 기준으로 검색한다. (대소문자 무시, 단순 부분일치)

Inputs: query (required), in.

update_note노트 수정A

기존 노트의 본문과 frontmatter를 수정한다. mode로 본문 갱신 방식을 정하고, 속성 파라미터를 넘기면 해당 frontmatter 키만 병합한다(나머지는 보존, 키 순서 유지).

Inputs: path (required), date, mode, tags, +7 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct operation: create/read/update for notes, list/create for directories, search across notes, and vault info. No overlapping purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (create_note, read_note, update_note, list_directory, create_directory, search_notes, get_vault_info).

    Tool Count5/5

    7 tools is well-scoped for an Obsidian vault server, covering note operations, directory management, search, and vault metadata without redundancy.

    Completeness3/5

    The note lifecycle covers create, read, and update but lacks delete note and delete directory operations, which are fundamental for full CRUD. Search and directory listing are present, but deletions are a notable gap.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude Code read/write access to an Obsidian vault, including creating, editing, searching, and browsing notes.
      8
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables reading, writing, searching, and managing an Obsidian vault through Claude, operating directly on markdown files via Node.js fs without requiring the Obsidian app.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude to search, read, write, and manage a local markdown vault through 8 tools, turning your notes into an AI-accessible knowledge base.
      3 npm
      AGPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables bidirectional interaction with Obsidian vaults, allowing reading, writing, and organizing notes through Claude.
      MIT