# Obsidian Vault MCP

Obsidian Vault MCP is a Model Context Protocol (MCP) server that keeps a live copy of an Obsidian vault synced through obsidian-headless and exposes it to Claude or other MCP clients over Streamable HTTP. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3139/obsidian-vault-mcp

## Description

Obsidian Vault MCP is a Model Context Protocol (MCP) server that keeps a live copy of an Obsidian vault synced through obsidian-headless and exposes it to Claude or other MCP clients over Streamable HTTP. It lets Claude read and write notes from any device, with edits syncing back through Obsidian Sync. It is for homelab users who want Obsidian notes accessible to AI assistants, and it requires an Obsidian Sync subscription.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 67 (last commit 103 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/obsidian-vault-mcp-0qidfxk1ydk2no?q=obsidian-vault-mcp

## Common questions

### How do I let Claude web/mobile reach my self-hosted Obsidian Vault MCP?

Expose the container over public HTTPS using Tailscale Funnel, Cloudflare Tunnel, or a reverse proxy. Claude connectors originate from Anthropic's cloud, so a plain LAN URL is not enough.

### What volumes should I mount and what do they contain?

Mount /vault for the synced Obsidian vault and /data for the Obsidian Sync session, obsidian-headless install, and MCP token. These are the paths used by the Docker setup.

### Which Obsidian credentials and security settings does the container need?

Set OBSIDIAN_EMAIL and OBSIDIAN_PASSWORD for account login, add OBSIDIAN_TOTP_SECRET if 2FA is enabled, and set OBSIDIAN_VAULT_PASSWORD only if the vault uses end-to-end encryption.

### How can I prevent Claude from editing notes?

Set READ_ONLY=true to disable the write tools.

### Can I pin the obsidian-headless version?

Set OBSIDIAN_HEADLESS_VERSION to pin the obsidian-headless version installed on first start. The image downloads obsidian-headless from npm instead of bundling it.

## Alternatives

- AFFiNE: AFFiNE is a privacy-focused, local-first, open-source workspace that merges docs, canvas, and tables into a single platform as an alternati…
- Anchor: Anchor is an offline-first, self-hostable note-taking application for people who want private, local notes with rich editing, tags, attachm…
- Anytype: Organizes notes, tasks, and projects offline using Markdown, P2P syncing, and encrypted storage, complemented by dynamic collections on all…
- AppFlowy: AppFlowy is an open-source, AI-powered workspace for managing projects, wikis, and team collaboration.
- Colanode: Colanode is an open-source, local-first self-hosted workspace for real-time chat, Notion-style documents, and customizable databases that h…
- Google Keep: Multifunctional cross-device tool captures ideas, lists, voice/photo notes.
- Ignis: Ignis is a compatibility shim that runs Obsidian as a self-hosted web app by providing browser-compatible Electron APIs, giving users a bro…
- Joplin: Open source note-taking app with Markdown support, to-do integration, and synchronization with cloud services like Dropbox and OneDrive.
- Logseq: Logseq is a privacy-first, open-source platform for knowledge management and collaboration.
- Memos: A modern, open-source, self-hosted knowledge management and note-taking platform designed for privacy-conscious users and organizations.
- Microsoft OneNote: Microsoft OneNote, part of the Microsoft 365 Copilot, is a digital notebook application that gives people one place to gather notes and inf…
- Nexlore: Nexlore is a notes app for your own server, in the browser: Markdown files on your disk, written in a real editor (WYSIWYG, slash menu, tab…

---
Source: Our Local Host (https://ourlocalhost.com/app/3139/obsidian-vault-mcp), the self-hosted and open-source app directory.
