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…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
40/100 Fair
- Maintained
- 67last commit 103 days ago
- Popular
- 00 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 19 days ago
- GitHub stars
- 0
- Open issues
- 1
- Last commit
- 2026-08-10
- Latest release
- v1.2.0
- License
- MIT
- Activity
- stale
Checked 6 days ago - source: GitHub (jakergirard/obsidian-vault-mcp)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Register Obsidian and icon module first Put the Obsidian and Lucide icon files in ReplicatedStorage, load them with require, and call Library:SetIconModule(Icons) before creating any UI. If you skip this, icons won't be registered and the UI setup can fail. source
- Link ThemeManager to Obsidian first If you use the optional ThemeManager, run ThemeManager:SetLibrary(Library) after loading Obsidian and the addon. Without that link, the theme controls won't know which UI to update, so applying themes won't work. source
- Setup and first start Requires an Obsidian Sync subscription. To reach it from Claude web/mobile, expose it over public HTTPS using Tailscale Funnel, Cloudflare Tunnel, or a reverse proxy, because Claude connectors originate from Anthropic's cloud. obsidian-headless is downloaded from npm on first start and is not bundled in the image. source
- Configuring an MCP client On first connect, give your MCP client (such as Claude) the server's bearer-token; the vault is exposed over MCP Streamable HTTP, and a valid Obsidian Sync subscription is required for the continuous local sync. source
Fetched today - each note links to its source
Variants
Alternatives (12)
- 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…
Checked 40 days ago - source: AlternativeTo
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.
Answers sourced from github.com
Community
- Self-Hosting Obsidian vaults : r/ObsidianMD - Reddit (reddit)
- Vault Cortex: an open-source MCP server that gives AI tools read and ... (forum)
- Vault as MCP - Obsidian Plugin (other)
- Obsidian MCP servers: experiences and recommendations? (forum)
- Semantic Notes Vault MCP - Obsidian Plugin (other)
Collected 49 days ago - public community threads