MCP 호환 어시스턴트가 명시적으로 구성된 Obsidian 금고를 안전하게 읽고 수정할 수 있도록 하는 로컬 모델 컨텍스트 프로토콜 서버입니다.

버전 2는 기본적으로 MCP [2026-07-28와 2025년 버전 클라이언트를 모두 지원하며, Node.js 22 이상이 필요합니다. Markdown 파일과 직접 작동하므로 Obsidian이 열려 있을 필요가 없습니다. 레거시 프로토콜과 v1 위치-경로 호환성은 폐기되었으며, 정확한 마이그레이션 지침을 stderr로 출력합니다.

[! 중요] MCP 클라이언트는 파괴 도구를 호출할 수 있습니다. 중요한 볼트를 백업하고, 클라이언트 권한 프롬프트를 검토하며, 동시에 편집된 노트에 대한 수정 전제 조건을 사용할 수 있습니다.

퀵 스타트

Node.js 22세 이상 이상이 필요합니다:

패키지를 전역적으로 설치하지 않고 npx로 실행하세요. 주요 버전을 고정하면 향후 주요 버전과 자동으로 교차하지 않고 호환되는 2.x 업데이트를 받습니다:

MCP 클라이언트가 stdio에서 같은 명령을 실행하도록 설정하세요:

또는 패키지를 전역적으로 설치하고 "command": "obsidian-mcp"를 사용하고, "serve"부터 시작하는 동일한 인수로 사용합니다:

각 볼트는 이미 .obsidian 디렉터리를 포함해야 하며, 절대 경로를 사용해 구성되어야 합니다.

Obsidian MCP

A local Model Context Protocol server that lets MCP-compatible assistants safely read and modify explicitly configured Obsidian vaults.

Version 2 supports both MCP 2026-07-28 and 2025-era clients by default, and requires Node.js 22 or newer. It works directly with Markdown files, so Obsidian does not need to be open. Legacy protocol and v1 positional-path compatibility are deprecated and print exact migration instructions to stderr.

[!IMPORTANT] MCP clients can invoke destructive tools. Back up important vaults, review client permission prompts, and use revision preconditions for concurrently edited notes.

Quick start

Node.js 22 or newer is required:

node --version # v22 or newer

Run with npx without installing the package globally. Pinning the major version receives compatible 2.x updates without automatically crossing a future major version:

npx -y obsidian-mcp@2 serve --vault notes=/absolute/path/to/vault

Configure an MCP client to launch the same command over stdio:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp@2", "serve", "--vault", "notes=/absolute/path/to/vault"]
    }
  }
}

Alternatively, install the package globally and use "command": "obsidian-mcp" with the same arguments beginning at "serve":

npm install -g obsidian-mcp@2

Each vault must already contain an .obsidian directory and must be configured using an absolute path.

Both protocol eras are served from the same tool definitions. After confirming that your MCP client negotiates 2026-07-28, you may opt into modern-only mode by adding "--legacy", "reject" to args.

Vault ids use lowercase letters, digits, _, and -, must begin with a letter, and are the values assistants pass to tools. Up to ten vaults may be configured. Repeat --vault to expose more than one vault:

obsidian-mcp serve \
  --vault work=/Users/me/Documents/WorkVault \
  --vault personal=/Users/me/Documents/PersonalVault

Network, removable, hidden, and synced locations are allowed because an explicit --vault is treated as authorization; the same containment protections apply to every location.

Design principles

• Vault access is explicitly allowlisted at process startup.
• Every tool path is vault-relative, segment-checked, and blocked from symlinks and reserved state.
• File mutations are journaled, conflict-checked, atomically replaced, and rolled back as one transaction.
• The server never listens on a network interface or sends telemetry.
• stdout is reserved exclusively for MCP messages; structured diagnostics go to stderr.
• Results are bounded, paginated where appropriate, and available as both text and structured content.

Tools

| Tool | Purpose |