ObsidianのObsidianプラグインで、Claude CodeとObsidianのボールトとの統合を可能にするMCP(Model Context Protocol)サーバーを実装しています。

このプラグインは、Claude Codeや他のMCPクライアント(Claude Desktopなど)がObsidian Vaultとやり取りできるようにし、AIを活用したノートやファイルへの直接アクセスをサポートします。

特徴

• デュアルトランスポートMCPサーバー:WebSocket(Claude Code用)およびHTTP/SSE(Claude Desktop用)の両方をサポートしています
• 自動発見:クロードコードが自動的にあなたのボールトを見つけて接続します
• ファイル操作:MCPプロトコルを使ったボールトファイルの読み書き
• Workspace コンテキスト:現在のアクティブなファイルおよびボールト構造をClaudeに提供します
• 複数のクライアントサポート:Claude CodeとClaude Desktopの両方を同時に接続
• 設定可能なポート:複数のボールトを運用する際の競合回避

MCPクライアント構成

このプラグインは、さまざまなClaudeクライアントが接続できるMCPサーバーとして機能します。異なるクライアントの設定方法は以下の通りです:

Claude デスクトップ(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