iansinnott avatar

Obsidian Claude Code

iansinnott/obsidian-claude-code-mcp

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 tools

Public 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)


View the full README on GitHub

Details

Repository
github.com/iansinnott/obsidian-claude-code-mcp
Category
Documents & Knowledge

Related Documents & Knowledge MCP servers

View all
1ergut avatarMCP LogSeq Serverergut/mcp-logseqMCP server to interact with LogSeq via its Local HTTP API - enabling AI assistants like Claude to seamlessly read, write, and manage your LogSeq graph.267stars
2kujenga avatarZotero MCPkujenga/zotero-mcpSearch your Zotero library, retrieve item metadata, and read full text from AI assistants.162stars
3pvliesdonk avatarMarkdown Vault MCPpvliesdonk/markdown-vault-mcpGeneric markdown vault MCP with hybrid search38stars
4epochal-dev avatarOpen Notebookepochal-dev/open-notebook-mcpMCP server that wraps the Open Notebook API30stars
5keshrath avatarAgent Knowledgekeshrath/agent-knowledgeCross-session memory for AI agents - knowledge graph, scoring, semantic search19stars
6oleksandrkucherenko avatarObsidian Vault MCP Serveroleksandrkucherenko/mcp-obsidian-via-restAccess Obsidian vaults via Local REST API - read, search, and interact with notes13stars