istefox

Obsidian MCP Connector — Development skill for Claude Code

Development community

Your Obsidian vault, exposed to Claude, Codex, Cursor and any MCP client.

How to install Obsidian MCP Connector

This entry records only its repository, not the path inside it, so there is no exact command to give. Open istefox/obsidian-mcp-connector and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Obsidian MCP Connector does

Your Obsidian vault, exposed to Claude, Codex, Cursor and any MCP client. Runs inside Obsidian, on-device semantic search, no cloud round-trip, no binary to download.

Alternatives in Development

  • API — All methods are exposed as MCP tools 1.7k ★
  • Katmer Code — Claude Code inside Obsidian — academic research skills, inline diff editing, MCP support 353 ★
  • Connector Discovery Skill — Triggers: - Invoked during onboarding Phase 3.5 (after archetype detection) - Invoked by capability-suggester 209 ★

README

MCP Connector for Obsidian

[!WARNING] **Known issue: on Obsidian 1.14 (Electron 43) the window can go blank while this plugin loads.** It affects macOS and Windows and is a crash of Obsidian's renderer, not an error thrown by this plugin. **Update to 3.1.1 or later.** The crash reports hold two signatures. The first, V8 stopping inside a read of Node's `AsyncLocalStorage`, is gone since 3.1.0, which no longer uses it inside Obsidian: on one Mac with Obsidian 1.14.5 (Electron 43.8.3), toggling the plugin off and on, 3.0.3 crashed on the first reload and 3.1.0-alpha.2 (the same fix as 3.1.0) crashed once in 200. The second is V8 running out of JavaScript heap: every reload of the plugin kept the previous instance in memory, about 40 MB each, through a global that the plugin's schema library registers and never removes. 3.1.1 removes it when the plugin unloads: on one Mac with Obsidian 1.15.0 (Electron 43.8.3), 420 reloads, with and without MCP clients connected, and no crash. The Electron 43.8.3 that ships with the Obsidian 1.14.5 installer changes neither on its own. I saw no crash on Electron 39.8.3 (Obsidian installer 1.12.7). If the window goes blank, restart Obsidian: the plugin usually loads on the next try. Reported to Obsidian [on their forum](https://forum.obsidian.md/t/renderer-sigsegv-on-macos-and-windows-with-electron-43-obsidian-1-14-4-when-a-large-community-plugin-loads-none-on-electron-39-8-3/119487), tracked here in [#597](https://github.com/istefox/obsidian-mcp-connector/issues/597) and [#609](https://github.com/istefox/obsidian-mcp-connector/issues/609).

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/istefox/obsidian-mcp-connector?display_name=tag)](https://github.com/istefox/obsidian-mcp-connector/releases/latest) [![Build status](https://img.shields.io/github/actions/workflow/status/istefox/obsidian-mcp-connector/release.yml)](https://github.com/istefox/obsidian-mcp-connector/actions) [![License](https://img.shi