Obsidian Claude Code

Obsidian Claude Code is an MCP server that integrates Obsidian markdown vaults directly with AI assistants including Claude Code and Claude Desktop. Running natively as an Obsidian plugin, it deploys a local server supporting both WebSocket connections and HTTP with Server-Sent Events (SSE). Software developers, researchers, and knowledge workers use this server to provide AI clients with direct access to their local notes, workspace structures, and active documents. The plugin allows assistants to read, create, modify, and search vault files without requiring manual copy-pasting. By exposing Obsidian workspace context—such as the currently active file, directory listings, and diagnostics—it enables language models to assist with technical documentation, knowledge base maintenance, and project planning directly inside local workflows. Multiple clients can connect simultaneously across configurable network ports, ensuring distinct vault environments operate without port collisions.

Category: Developer Tools & Code Intelligence

Tags: claude-code, knowledge-management, markdown, obsidian, vault

Visit Obsidian Claude Code

How to install and configure Obsidian Claude Code

1. Install and enable the Obsidian Claude Code plugin inside your Obsidian vault. 2. Ensure Node.js is installed locally to run bridge utilities. 3. For Claude Desktop, open your claude_desktop_config.json file. 4. Add the server entry using mcp-remote to bridge the SSE endpoint: json { "mcpServers": { "obsidian": { "command": "npx", "args": ["mcp-remote", "http://localhost:22360/sse"], "env": {} } } } 5. Restart Claude Desktop to apply the configuration. 6. For Claude Code CLI, run claude in your terminal, type /ide, and select Obsidian from the IDE list to connect over WebSocket.

What you can do with Obsidian Claude Code

• Reading and writing markdown notes across your local Obsidian vault using natural language instructions in Claude. - Inspecting the currently active Obsidian document to receive contextual drafting, editing, and code suggestions. - Searching and listing workspace files to generate comprehensive summaries, project indexes, or daily log reviews. - Executing string replacements and inserting text segments automatically across multiple linked documentation files. - Running diagnostics and checking vault structures directly through Claude Code CLI terminal sessions.

Key facts

• Open Source
• https://github.com/iansinnott/obsidian-claude-code-mcp
• Developer Tools & Code Intelligence, Notes & Knowledge Management
• claude-code, knowledge-management, markdown, obsidian, vault

Part of MCP Servers

What is Obsidian Claude Code?

Obsidian Claude Code is an Obsidian community plugin that runs an MCP server inside your vault. It exposes your notes, workspace files, and active document context to compatible MCP clients, enabling automated file operations and AI assistance.

Which MCP clients work with Obsidian Claude Code?

The server supports Claude Code via automated WebSocket discovery and Claude Desktop via an HTTP SSE bridge using mcp-remote. Any other MCP client with native support for legacy HTTP with SSE can also connect.

What tools does Obsidian Claude Code provide?

The plugin exposes file operations such as view, str_replace, create, and insert. It also provides workspace tools including get_current_file, get_workspace_files, and obsidian_api, alongside IDE-specific diagnostic tools for Claude Code.

How do I handle port conflicts with multiple vaults?

The server defaults to port 22360. If you run multiple vaults simultaneously, open Obsidian Settings, navigate to Community Plugins, select Claude Code, and adjust the HTTP Server Port before updating your client configuration.

Is Obsidian Claude Code open source?

Yes, Obsidian Claude Code is an open source project distributed on GitHub under the repository iansinnott/obsidian-claude-code-mcp.