Obsidian 플러그인으로, Claude Code가 Obsidian 볼트와 통합될 수 있도록 MCP(Model Context Protocol) 서버를 구현합니다.

이 플러그인은 Claude Code와 Claude Desktop 같은 다른 MCP 클라이언트가 Obsidian 금고와 상호작용할 수 있게 해주며, AI 기반 지원을 통해 노트와 파일에 직접 접근할 수 있게 합니다.

특징

• 듀얼 트랜스포트 MCP 서버: WebSocket(클로드 코드용)과 HTTP/SSE(클로드 데스크톱용) 모두를 지원합니다
• 자동 발견: 클로드 코드가 자동으로 금고를 찾아 연결해 줍니다
• 파일 작업: MCP 프로토콜을 통한 볼트 파일 읽기 및 쓰기
• Workspace Context: 현재 활성 파일 및 볼트 구조를 Claude에 제공합니다
• 다중 클라이언트 지원: Claude 코드와 Claude 데스크톱을 동시에 연결할 수 있습니다
• 구성 가능한 포트: 여러 볼트를 실행할 때 충돌 방지

MCP 클라이언트 구성

이 플러그인은 다양한 Claude 클라이언트가 연결할 수 있는 MCP 서버 역할을 합니다. 다음은 다양한 클라이언트를 구성하는 방법입니다:

클로드 데스크탑 (2025-06-09 기준)

Claude Desktop은 HTTP 전송을 직접 지원하지 않기 때문에 Obsidian MCP 서버에 연결하기 위해 특별한 구성이 필요합니다.

Obsidian Claude Code

An Obsidian plugin that implements an MCP (Model Context Protocol) server to enable Claude Code integration with Obsidian vaults.

This plugin allows Claude Code and other MCP clients (like Claude Desktop) to interact with your Obsidian vault, providing AI-powered assistance with direct access to your notes and files.

Features

• Dual Transport MCP Server: Supports both WebSocket (for Claude Code) and HTTP/SSE (for Claude Desktop)
• Auto-Discovery: Claude Code automatically finds and connects to your vault
• File Operations: Read and write vault files through MCP protocol
• Workspace Context: Provides current active file and vault structure to Claude
• Multiple Client Support: Connect both Claude Code and Claude Desktop simultaneously
• Configurable Ports: Avoid conflicts when running multiple vaults

MCP Client Configuration

This plugin serves as an MCP server that various Claude clients can connect to. Here’s how to configure different clients:

Claude Desktop (as of 2025-06-09)

Claude Desktop requires a special configuration to connect to the Obsidian MCP server because it does not directly support HTTP transports. We will use mcp-remote, a tool that creates a local stdio bridge to the server’s HTTP endpoint.

Configuration Steps:

1. Install and enable this plugin in Obsidian.

2. Make sure you have Node.js installed, as npx (which comes with Node.js) is used to run the bridge tool.

3. Locate your Claude Desktop config file:

   • macOS: $HOME/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

4. Add the Obsidian MCP server to your config using the mcp-remote command. npx will automatically download and run it for you.

   {
   	"mcpServers": {
   		"obsidian": {
   			"command": "npx",
   			"args": ["mcp-remote", "http://localhost:22360/sse"],
   			"env": {}
   		}
   	}
   }
   

5. Restart Claude Desktop after making the configuration change.

6. Test the connection by asking Claude about your vault: “What files are in my Obsidian vault?”

Other MCP Clients (with direct HTTP support)

If you are using an MCP client that directly supports the legacy “HTTP with SSE” transport, you can use a simpler configuration without the mcp-remote bridge.

Example Configuration:

{
	"mcpServers": {
		"obsidian": {
			"url": "http://localhost:22360/sse",
			"env": {}
		}
	}
}

Claude Code CLI

Claude Code automatically discovers and connects to Obsidian vaults through WebSocket.

Usage Steps:

1. Install and enable this plugin in Obsidian
2. Run Claude Code in your terminal: claude
3. Select your vault using the /ide command
4. Choose “Obsidian” from the IDE list
5. Claude Code will automatically connect via WebSocket

Port Configuration