Obsidian MCP Tools

왜 쓰나요

핵심 기능

로컬 Obsidian 플러그인 + MCP 브릿지
Smart Connections 통합을 통한 시맨틱 검색
Claude에서 Templater 프롬프트 실행
완전한 파일 CRUD: 읽기, 쓰기, 추가, 링크, frontmatter
데일리 노트 + 저널 인식
Vault 데이터는 절대 로컬을 벗어나지 않음

라이브 데모

실제 사용 모습

obsidian-mcp-tools.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Obsidian MCP Tools

grep 대신 세컨드 브레인을 실제로 쿼리하는 방법

👤 1000개 이상의 노트가 있는 Obsidian PKM 사용자 ⏱ ~20 min intermediate

언제 쓸까: 몇 달 전에 무언가를 작성했다는 걸 알지만 키워드 검색으로는 계속 놓칠 때.

사전 조건

Obsidian + 이 플러그인 + Smart Connections 플러그인 — 커뮤니티 플러그인에서 둘 다 설치; Smart Connections가 첫 실행 시 인덱싱 시작

흐름

인덱스 확인

Verify Smart Connections has finished embedding my vault. Report total notes indexed.✓ 복사됨

→ 인덱싱된 노트 수; 사용 중인 임베딩 모델
시맨틱 회상

Find notes related to 'why I left my last job' even if those exact words aren't in any note.✓ 복사됨

→ 시맨틱 매치로 순위가 매겨진 5개 노트와 스니펫
작성

Synthesize those into a short reflection note. Save under /Reflections/ with a wikilink to each source.✓ 복사됨

→ 새 노트 생성됨; 백링크 resolve됨

결과: 키워드가 아닌 개념으로 답하는 세컨드 브레인.

함정

시맨틱 회상이 민감한 개인 노트를 표시 — Smart Connections의 excludedFolders 설정을 사용하여 비공개 디렉토리를 건너뛰세요

함께 쓰기: humanizer-skill

Claude에서 프롬프트 자동 완성으로 Templater 템플릿 실행

👤 템플릿을 사용하는 파워 Obsidian 사용자 ⏱ ~10 min intermediate

언제 쓸까: 5개의 프롬프트를 요청하는 '프로젝트 킥오프' Templater 템플릿이 있고 Claude가 이를 오케스트레이션하기를 원할 때.

사전 조건

템플릿이 설정된 Templater 설치 — 표준 커뮤니티 플러그인

흐름

템플릿 목록

What Templater templates are available?✓ 복사됨

→ 프롬프트 설명이 있는 템플릿 목록
자동 완성으로 실행

Run 'project_kickoff' for a project called 'Q3 onboarding overhaul'. Auto-answer the prompts based on context.✓ 복사됨

→ 템플릿을 사용하여 새 노트 생성됨; 프롬프트 완성됨

결과: 모달 대신 채팅에서 실행되는 템플릿.

함정

일부 Templater 명령이 비동기적으로 시간이 필요 — MCP 도구가 완료를 기다립니다 — 하지만 한 번의 호출에 너무 많이 체인하지 마세요

어제의 캘린더 + 할 일에서 데일리 노트 자동 생성

👤 생산성 중심 Obsidian 사용자 ⏱ ~15 min intermediate

언제 쓸까: 매일 같은 'Daily' 템플릿을 편집하기 시작하는 경우 — 자동화하세요.

흐름

오늘의 데이터 수집

Read yesterday's daily note. Carry forward incomplete tasks. Pull today's calendar via google-calendar MCP.✓ 복사됨

→ 이월된 작업 + 오늘의 이벤트 식별
데일리 작성

Create today's daily note in /Daily/$(date +%F).md with the standard sections.✓ 복사됨

→ 노트 생성 및 열림

결과: 5초 만에 준비되는 데일리 노트.

함정

같은 작업이 2일에 있으면 이월 시 중복 — 쓰기 전에 줄 텍스트로 중복 제거

함께 쓰기: google-calendar

조합

다른 MCP와 조합해 10배 효율

obsidian-mcp-tools + google-calendar

당일 이벤트를 포함하는 데일리 노트 작성

obsidian-mcp-tools + github

프로젝트 보드를 vault 노트에 미러링

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
search_semantic	query, k?	개념 수준의 회상	1 Smart Connections query
read_note	path	단일 노트 조회	free
write_note	path, content, mode: 'create'\|'append'\|'overwrite'	노트 생성 또는 업데이트	free
list_templates	(none)	실행 가능한 것 확인	free
run_templater	template_name, prompt_answers: {}	템플릿 워크플로 실행	free

비용 및 제한

운영 비용

API 쿼터: 로컬 — 클라우드 기반 Smart Connections 임베딩 서비스 사용 시 해당 서비스에 따라 결정
호출당 토큰: 노트당 100~1500
금액: 무료 (플러그인); Smart Connections는 무료 로컬 + 유료 클라우드 옵션 있음
팁: 쿼리 비용을 피하려면 Smart Connections에서 로컬 임베딩 옵션을 사용하세요

보안

권한, 시크릿, 파급범위

자격 증명 저장: 로컬 플러그인만; 원격 저장 없음

데이터 외부 송신: 로컬 — Smart Connections가 클라우드 임베딩으로 설정된 경우 제외

신뢰하지 않는 프롬프트로는 Claude에게 vault 쓰기 접근을 허용하지 마세요; 민감한 영역에는 제외 폴더를 사용하세요

문제 해결

자주 발생하는 오류와 해결

MCP 도구가 표시되지 않음

Obsidian 플러그인이 활성화되어 있고 MCP 브릿지 프로세스가 실행 중인지 확인하세요

확인: 플러그인 상태 표시줄 확인; Obsidian 재시작

search_semantic이 아무것도 반환하지 않음

Smart Connections 임베딩 작업이 아직 완료되지 않았을 수 있습니다 — 진행 상황 확인

확인: Smart Connections 사이드바 열기

write_note가 'path outside vault' 오류

경로는 vault 루트에 상대적입니다; 절대 경로를 사용하지 마세요

대안