Obsidian MCP Server MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

메모, 태그, 머리말, 검색을 다루는 8가지 도구
추가/앞에 추가/덮어쓰기 업데이트 모드 - 에이전트가 전체 파일을 다시 생성할 필요가 없습니다.
Atomic Frontmatter 키 수준 작업
저장소 전체에 걸친 전역 퍼지 검색
더 빠른 반복 읽기를 위한 캐싱 계층

라이브 데모

실제 사용 모습

obsidian-mcp-server.replay ▶ 준비됨

0/0

설치

클라이언트 선택

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

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

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

사용 사례

실전 활용법: Obsidian MCP Server

모든 MCP 클라이언트에서 오늘의 일일 메모에 아이디어를 담아보세요.

👤 채팅에 참여하는 흑요석 사용자 ⏱ ~5 min beginner

언제 쓸까: Claude와 대화를 나누는 중에 앱을 전환하지 않고도 생각을 저장소에 저장하고 싶습니다.

사전 조건

로컬 REST API 플러그인이 활성화된 Obsidian — 커뮤니티 플러그인 → '로컬 REST API' 설치 → API 키 복사
OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL로 구성된 MCP 클라이언트 — 구성 블록을 참조하세요. 기본 URL은 일반적으로 http://127.0.0.1:27123입니다.

흐름

일일 메모가 있는지 확인하세요.

Daily/2026-04-17.md 아래에 메모를 나열하세요.✓ 복사됨

→ 파일 경로가 확인되었거나 '찾을 수 없음'
캡처 추가

Daily/2026-04-17.md에 '- Idea: try X for the caching bug'를 추가합니다.✓ 복사됨

→ 이전 항목을 덮어쓰지 않고 확인된 추가

결과: 에이전트가 추가할 수 있는 실행 중인 저널입니다.

함정

추가를 의미할 때 덮어쓰기 모드 사용 — 항상 기본적으로 일일 메모에 추가하거나 앞에 추가합니다. 새로운 초안을 위해 덮어쓰기 저장

함께 쓰기: filesystem

일주일 간의 메모를 검토 문서로 전환

👤 주간 검토를 수행하는 지식 작업자 ⏱ ~20 min intermediate

언제 쓸까: 한 주의 흩어져 있는 노트 전체에 걸쳐 금요일 종합이 필요합니다.

사전 조건

태그가 있거나 날짜가 있는 메모 — #weekly 또는 Daily/ 폴더 사용

흐름

이번주 노트 검색

글로벌 검색: Daily/에서 이번 주에 수정된 노트입니다.✓ 복사됨

→ 5~7개의 파일 경로 목록
각각 읽어보세요

각 일일 노트를 읽고 주제별로 요약하세요.✓ 복사됨

→ 원시 연결이 아닌 테마 글머리 기호
리뷰 작성

Reviews/2026-W16.md에 요약을 작성하세요. 서두 상태 추가: 검토, 태그: [주간].✓ 복사됨

→ 적절한 머리말이 포함된 새 파일

결과: 수동으로 복사하여 붙여넣지 않고 원본 자료로 작성된 주간 검토 노트입니다.

함께 쓰기: github

볼트 전체에서 지저분한 태그를 통합합니다.

👤 유기적으로 성장하여 이제 #Work / #work / #WORK 변형이 있는 Vault ⏱ ~30 min intermediate

언제 쓸까: 중복 및 거의 중복으로 인해 태그 목록이 너무 깁니다.

흐름

현재 태그 나열

obsidian_manage_tags를 사용하여 사용법별로 정렬된 모든 태그를 나열합니다.✓ 복사됨

→ 태그 수를 통해 중복 항목 표시
매핑 제안

표준 집합과 기존 → 새 매핑을 제안합니다.✓ 복사됨

→ 작고 검토 가능한 테이블
일괄 적용

확인한 후 매핑을 사용하여 저장소 전체에서 태그 이름을 바꿉니다.✓ 복사됨

→ 메모별로 요약된 태그 작업

결과: 실제로 탐색할 수 있는 깔끔한 태그 분류입니다.

함정

백업 없이 수백 개의 노트를 한 번에 다시 작성 — 먼저 저장소를 git에 커밋합니다. 차이점을 검토해 보세요

함께 쓰기: git

웹 스크랩을 연구 받은 편지함에 넣고 자동으로 태그를 지정하세요.

👤 연구원, 분석가, 클리퍼 습관이 있는 모든 사람 ⏱ ~15 min beginner

언제 쓸까: 받은 편지함/폴더는 처리할 수 있는 것보다 빠르게 쌓입니다.

사전 조건

지정된 받은 편지함/폴더 — 볼트에 생성하세요

흐름

받은편지함 나열

Inbox/ 아래에 태그가 지정되지 않은 메모를 나열합니다.✓ 복사됨

→ 보류 중인 항목의 경로
분류 및 태그

각각에 대해 콘텐츠를 기반으로 1~3개의 태그를 제안한 다음 obsidian_manage_tags를 사용하여 적용하세요.✓ 복사됨

→ Frontmatter를 통해 원자적으로 추가된 태그

결과: 받은 편지함은 작게 유지됩니다. 새로운 클립이 자동으로 정리됩니다.

함께 쓰기: fetch

조합

다른 MCP와 조합해 10배 효율

obsidian-mcp-server + fetch

가져오기를 사용하여 URL을 클립한 다음 Inbox/에 쓰세요.

https://...를 가져오고 정리된 요약을 적절한 머리말과 함께 Inbox/YYYY-MM-DD-title.md에 저장합니다.✓ 복사됨

obsidian-mcp-server + github

병합된 PR 요약을 Projects/<repo>.md에 복사합니다.

이번 주에 병합된 PR을 찾아 Projects/acme-api.md의 ## Week 16 아래에 요약을 추가하세요.✓ 복사됨

obsidian-mcp-server + git

Vault 버전을 지정하고 일괄 변경 사항을 커밋합니다.

태그 정리 후 볼트에서 git diff를 실행하고 커밋하기 전에 요약합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
obsidian_read_note	path: str	특정 메모를 편집하거나 요약하기 전에 읽어보세요.
obsidian_update_note	path: str, content: str, mode: 'append'\|'prepend'\|'overwrite'	메모 내용 추가 또는 교체 - 다시 작성하지 않는 한 기본적으로 추가됩니다.
obsidian_search_replace	path: str, find: str, replace: str	전체 파일을 재생성하지 않고 대상 노트 내 편집
obsidian_global_search	query: str, filters?	전체 저장소에서 메모 찾기
obsidian_list_notes	folder?: str	일괄 작업 전에 폴더의 메모 열거
obsidian_manage_frontmatter	path: str, op: 'get'\|'set'\|'delete', key?: str, value?: any	원자적, 키 수준의 앞부분 변경
obsidian_manage_tags	path?: str, op: 'list'\|'add'\|'remove'	태그 위생 및 분류 작업
obsidian_delete_note	path: str	메모 제거 - 영구적이며 취소할 수 없음

비용 및 제한

운영 비용

API 쿼터: 외부 API 없음 - 로컬 REST API가 Mac/PC에서 실행됩니다.
호출당 토큰: 노트 크기의; 일반 200~3000
금액: 무료
팁: 전체 폴더를 컨텍스트에 맞게 대량 나열하는 대신 global_search + 요청 시 읽기를 선호합니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: env var의 OBSIDIAN_API_KEY만 — 커밋되지 않습니다. 볼트에 대한 로컬 관리 토큰처럼 취급하십시오.

데이터 외부 송신: 모든 트래픽은 localhost → Obsidian Local REST API입니다. 이 서버에서는 클라우드 호출이 없습니다.

로컬 REST API 플러그인은 로컬 HTTP 포트에 저장소를 노출합니다. 127.0.0.1에만 바인딩하고 localhost에 대해서만 HTTPS를 끄십시오.
OBSIDIAN_API_KEY에 도달한 공격자는 저장소에서 전체 읽기/쓰기 권한을 얻습니다. 누출이 의심되는 경우 교체하세요.

문제 해결

자주 발생하는 오류와 해결

ECONNREFUSED 127.0.0.1:27123

Obsidian이 실행되고 있지 않거나 로컬 REST API 플러그인이 비활성화되어 있습니다. Obsidian을 열고 플러그인을 활성화하세요.

확인: curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/

401 무단

OBSIDIAN_API_KEY가 플러그인의 현재 키와 일치하지 않습니다. 플러그인 설정에서 값을 다시 복사하세요.

확인: Plugin Settings → Local REST API → copy the API key

알려진 파일에 대한 404

경로는 저장소 기준이며 대소문자를 구분합니다. obsidian_list_notes로 확인하세요.

확인: obsidian_list_notes folder='Daily'

대안

Obsidian MCP Server 다른 것과 비교

대안	언제 쓰나	단점/장점
obsidian-plugin-skill	Claude가 Vault 콘텐츠를 편집하는 것이 아니라 Obsidian 플러그인을 작성하는 데 도움을 주기를 원합니다.	다른 범위
filesystem MCP	원시 파일 작업에 문제가 없으며 Obsidian을 인식하는 앞부분/태그 API가 필요하지 않습니다.	원자 태그/프런트매트 작업이 손실됩니다.

Obsidian MCP Server

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: Obsidian MCP Server

모든 MCP 클라이언트에서 오늘의 일일 메모에 아이디어를 담아보세요.

사전 조건

흐름

함정

일주일 간의 메모를 검토 문서로 전환

사전 조건

흐름

볼트 전체에서 지저분한 태그를 통합합니다.

흐름

함정

웹 스크랩을 연구 받은 편지함에 넣고 자동으로 태그를 지정하세요.

사전 조건

흐름

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

Obsidian MCP Server 다른 것과 비교

더 보기

리소스