This Obsidian plugin implements the Model Context Protocol (MCP) server, enabling AI tools like Claude Code and Claude Desktop to directly interact with users' Obsidian vaults. It empowers Obsidian users by providing AI-powered assistance with contextual awareness of their notes and files, streamlining research, writing, and knowledge management workflows.

How It Works

The plugin acts as an MCP server, offering dual transport capabilities: WebSocket for Claude Code and HTTP/SSE for Claude Desktop, often requiring a bridge tool like mcp-remote. It features automatic discovery of Obsidian vaults by Claude Code and provides essential workspace context, including file structure and active file information. This architecture allows AI models to read, write, and understand the user's vault content, facilitating advanced AI-driven note-taking and content generation.

Quick Start & Requirements

• Installation: Install as an Obsidian Community Plugin.
• Prerequisites: Node.js is required for npx mcp-remote when configuring Claude Desktop.
• Configuration:
  • Claude Desktop: Requires adding an mcpServers entry to claude_desktop_config.json using npx mcp-remote http://localhost:22360/sse.
  • Claude Code: Automatically discovers vaults via WebSocket.
• Port: Defaults to port 22360; configurable in plugin settings.
• Links: No direct quick-start or demo links provided; configuration relies on Obsidian settings and client-specific JSON files.

Highlighted Details

• Dual Transport MCP Server supporting WebSocket and HTTP/SSE.
• Automatic vault discovery for Claude Code.
• File operations (read, write) and workspace context provision.
• Simultaneous support for multiple MCP clients (e.g., Claude Code and Claude Desktop).
• Configurable ports to manage multiple vaults or avoid conflicts.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project roadmap were found in the provided README text.

Licensing & Compatibility

The README text does not specify a software license. Compatibility for commercial use or closed-source linking is therefore undetermined.

Limitations & Caveats

The plugin intentionally uses an older MCP specification for HTTP transport ("HTTP with SSE", 2024-11-05) due to current client limitations with the latest "Streamable HTTP" protocol (2025-03-26). Integration with Claude Desktop necessitates Node.js and the mcp-remote bridge tool. Running multiple Obsidian vaults with the plugin requires assigning each a unique network port.