Obsidian Claude Code MCP Server

Use Claude Code within your notes.

Local serverstdioTypeScript

What is the Obsidian Claude Code MCP Server?

Use Claude Code within your notes.

The short version

An Obsidian plugin that implements an MCP (Model Context Protocol) server to enable Claude Code integration with Obsidian vaults.

  • 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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
getDiagnosticsSystem and vault diagnostics
openDiffDiff view operations (stub for Obsidian)
close_tabTab management (stub for Obsidian)
closeAllDiffTabsBulk tab operations (stub for Obsidian)

How to install the Obsidian Claude Code MCP Server

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:22360/sse"
      ],
      "env": {}
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use Obsidian Claude Code MCP to Troubleshooting.”

Frequently asked questions

Use Claude Code within your notes. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.