obsidian-local-mcp
Provides tools to create, read, update notes, manage folders, search notes, and get vault info in an Obsidian vault, treating a local directory as an Obsidian Vault.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@obsidian-local-mcp search for notes tagged 'todo'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 서버 ( | 7개 도구 제공 (아래) |
설정 페이지 ( | localhost 웹 UI — Vault 폴더 선택(네이티브 다이얼로그) + 기본 author |
스킬 ( | 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 build1) 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.jsInspector에서 get_vault_info → create_note → read_note → list_directory
순으로 호출해 동작을 확인할 수 있습니다.
Available Tools
7 toolscreate_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
Scored across 7 tools
Each tool targets a distinct operation: create/read/update for notes, list/create for directories, search across notes, and vault info. No overlapping purposes.
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).
7 tools is well-scoped for an Obsidian vault server, covering note operations, directory management, search, and vault metadata without redundancy.
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
Related MCP Connectors
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
Safe folder access for ChatGPT and Claude: read, write and search files, risky tools opt-in.
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables Claude Code read/write access to an Obsidian vault, including creating, editing, searching, and browsing notes.81MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityBmaintenanceEnables Claude to search, read, write, and manage a local markdown vault through 8 tools, turning your notes into an AI-accessible knowledge base.3 npmAGPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables bidirectional interaction with Obsidian vaults, allowing reading, writing, and organizing notes through Claude.MIT