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…

  • AI
  • Cloud
  • Productivity
  • Tools & Utilities
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
  • 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

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

Collected 49 days ago - public community threads