
Obsidian Claude Code
The Obsidian Claude Code MCP server enables Claude AI clients to interact with Obsidian vaults by implementing a dual-transport MCP server supporting both WebSocket (for Claude Code) and HTTP/SSE (for Claude Desktop). It provides file read/write operations, workspace context awareness, and allows multiple Claude clients to connect simultaneously to access vault files and structure. This integration solves the problem of bringing AI-powered assistance directly into Obsidian workflows without leaving the note-taking application.
- GitHub stars
- 287
- tools
- 11
- last updated
- Jan 11, 2026
Tools
11 toolsPublic tool metadata for what this MCP can expose to an agent.
viewShared file operation tool available to both IDE and MCP clients.
Shared file operation tool available to both IDE and MCP clients.
No parameter schema in public metadata yet.
str_replaceShared file operation tool available to both IDE and MCP clients.
Shared file operation tool available to both IDE and MCP clients.
No parameter schema in public metadata yet.
createShared file operation tool available to both IDE and MCP clients.
Shared file operation tool available to both IDE and MCP clients.
No parameter schema in public metadata yet.
insertShared file operation tool available to both IDE and MCP clients.
Shared file operation tool available to both IDE and MCP clients.
No parameter schema in public metadata yet.
get_current_fileShared workspace operation tool available to both IDE and MCP clients.
Shared workspace operation tool available to both IDE and MCP clients.
No parameter schema in public metadata yet.
get_workspace_filesShared workspace operation tool available to both IDE and MCP clients.
Shared workspace operation tool available to both IDE and MCP clients.
No parameter schema in public metadata yet.
obsidian_apiShared tool providing Obsidian API access, available to both IDE and MCP clients.
Shared tool providing Obsidian API access, available to both IDE and MCP clients.
No parameter schema in public metadata yet.
getDiagnosticsIDE-specific tool providing system and vault diagnostics, only available via Claude Code WebSocket.
IDE-specific tool providing system and vault diagnostics, only available via Claude Code WebSocket.
No parameter schema in public metadata yet.
openDiffIDE-specific diff view operation tool (stub for Obsidian), only available via Claude Code WebSocket.
IDE-specific diff view operation tool (stub for Obsidian), only available via Claude Code WebSocket.
No parameter schema in public metadata yet.
close_tabIDE-specific tab management tool (stub for Obsidian), only available via Claude Code WebSocket.
IDE-specific tab management tool (stub for Obsidian), only available via Claude Code WebSocket.
No parameter schema in public metadata yet.
closeAllDiffTabsIDE-specific bulk tab operation tool (stub for Obsidian), only available via Claude Code WebSocket.
IDE-specific bulk tab operation tool (stub for Obsidian), only available via Claude Code WebSocket.
No parameter schema in public metadata yet.
Sponsors
Readme
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)
Details
- Repository
- github.com/iansinnott/obsidian-claude-code-mcp
- Category
- Documents & Knowledge