Which integrations are available for this server?

Allows an LLM to search, read, and write notes in an Obsidian vault organized with the PARA method, including saving URLs as notes.

How do I use vault-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@vault-mcp save this URL to my 01-Inbox for later" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

vault-mcp

by KORThomasJeong

Overview Schema Related Servers Score Discussions

Python

Hybrid

vault-mcp

A small remote MCP server that lets an LLM (claude.ai, Claude Code, mobile) search, read, and write an Obsidian vault organised with the PARA method — and save URLs as notes.

The server holds no LLM of its own. It is a deterministic set of tools; the connecting model is the brain. When you ask it to "save this to my vault", the model calls vault_taxonomy to see your folder structure, picks the right folder itself, and calls vault_write.

claude.ai / Claude Code  ──https + Bearer token──▶  reverse proxy / TLS
                                                          │
                                                  127.0.0.1:8848 (this server)
                                                          │
                                                  ~/Obsidian/YourVault

Tools

Tool	What it does
`vault_taxonomy`	Returns the folder tree, PARA policy, and subcategory whitelists so the model can choose a destination folder.
`vault_search`	`semantic` (hybrid vector search) or `title` (exact name/path lookup).
`vault_read`	Returns a note's content. Machine-generated index/log files and legacy dumps are blocked.
`vault_write`	Create / overwrite / append a note. The caller supplies the folder. Writes are restricted to PARA buckets; the vault root is never written.
`vault_save_url`	Fetch a URL, extract clean text, save it as a note, and return a small preview.

Related MCP server: obsidian-local-mcp

Safety

Every path is resolved and confined to the vault root — no .. traversal, no absolute paths, no symlink escapes.
Writes are allowed only under 01-Inbox/, 10-Projects/, 20-Areas/, 30-Resources/, docs/.
Reads of regenerable index/map/log artifacts and legacy wiki backups are refused (they are huge and waste tokens).
A static Bearer token (MCP_AUTH_TOKEN) guards every request.

Install

git clone https://github.com/KORThomasJeong/vault-mcp.git
cd vault-mcp
cp .env.example .env        # then edit .env
uv sync

Generate an auth token:

python -c "import secrets; print(secrets.token_urlsafe(32))"

Configure

All config is via environment (see .env.example):

Var	Required	Default	Notes
`VAULT_PATH`	✅	—	Absolute path to the vault root.
`MCP_AUTH_TOKEN`		(none)	Bearer token. Set this for any internet-facing deployment.
`MCP_HOST`		`127.0.0.1`	Keep on localhost behind a proxy.
`MCP_PORT`		`8848`
`MCP_PATH`		`/mcp`
`FAST_SEARCH_BIN`		(none)	Warm semantic-search front-end, called `<bin> "<query>" -n <limit>`. Preferred over `QMD_BIN`.
`QMD_BIN`		`qmd`	Fallback semantic search helper. Blank + no `FAST_SEARCH_BIN` → that mode is disabled.
`WIKI_QUERY_BIN`		`wiki-query`	Title/path search helper. Blank → disabled.
`SAVE_LINK_BIN`		`obsidian-save-link`	URL→note helper. Blank → disabled.
`INDEX_REBUILD_CMD`		(none)	Command run when a tool is called with `rebuild_index=true`.

The search and URL-save tools shell out to optional companion CLIs. If you don't have them, those tools simply report that they're disabled — read/write/taxonomy still work.

Run

uv run vault-mcp
# serves Streamable HTTP at http://127.0.0.1:8848/mcp

Expose it through your existing reverse proxy (Caddy/nginx/Cloudflare) so that https://your-domain:port/mcp forwards to 127.0.0.1:8848.

Connect from Claude Code

claude mcp add --transport http vault https://your-domain:port/mcp \
  --header "Authorization: Bearer <your-token>"

Connect from claude.ai

Add a custom connector pointing at https://your-domain:port/mcp with the Authorization: Bearer <token> header. (claude.ai requires HTTPS.)

Develop

uv run --extra dev pytest

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/KORThomasJeong/vault-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server