Obsidian Vault MCP Server
Provides tools for interacting with a local Obsidian vault by working directly on its Markdown files, allowing notes to be listed, read, searched (by filename, content, text or regex), created, overwritten, appended to, edited via string replacement, moved, renamed and deleted. Also supports folder management, daily notes generated from a frontmatter template, frontmatter and tag management (adding tags, finding notes by tag, setting mood/custom fields), note metadata and word/line counts, recent notes, and vault-wide statistics such as totals, top folders, top tags and recorded moods.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Obsidian Vault MCP Server
A small MCP server, built with FastMCP, that lets an MCP client (Claude Desktop, Claude Code, etc.) read, write, search and organise notes in a local Obsidian vault. It works directly on the Markdown files; Obsidian does not need to be running.
Tools
Tool | What it does |
| List every |
| Read a note's full contents. |
| Search note filenames (and optionally contents) by text or regex. |
| Create a note, or overwrite one with |
| Append text to a note, optionally with a timestamp. |
| Replace every occurrence of an exact string in a note. |
| Show size, modified time, word and line counts. |
| Move a note to another folder. |
| Rename a note within its folder. |
| Delete a note (requires |
| List all folders in the vault. |
| Create a folder. |
| Create today's dated note from a frontmatter template. |
| Set |
| Add tags to a note's frontmatter, keeping existing ones. |
| Find notes with a tag (frontmatter or inline |
| Totals, top folders, top tags and recorded moods. |
| List the most recently modified notes. |
Hidden folders (such as .obsidian) are skipped. All paths are relative to the vault root, and paths that resolve outside the vault are refused.
Related MCP server: obsidian-mcp-server
Install
Requires Python 3.10+.
pip install -r requirements.txtConfiguration
Variable | Required | Default | Meaning |
| yes | none | Absolute path to your vault folder. |
| no |
| Folder (relative to the vault) for |
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"obsidian": {
"command": "python",
"args": ["/absolute/path/to/obsidian-vault-mcp/obsidian_server.py"],
"env": {
"OBSIDIAN_VAULT_PATH": "/absolute/path/to/your/vault",
"OBSIDIAN_DAILY_FOLDER": "Journal"
}
}
}
}On Windows, use paths like C:\path\to\vault (escaped backslashes) or forward slashes.
Claude Code
claude mcp add obsidian \
-e OBSIDIAN_VAULT_PATH=/absolute/path/to/your/vault \
-e OBSIDIAN_DAILY_FOLDER=Journal \
-- python /absolute/path/to/obsidian-vault-mcp/obsidian_server.pySafety
write_note (with overwrite=True), str_replace_in_note, update_note_frontmatter, add_tags_to_note, move_note, rename_note and delete_note change real files in your vault. Deletes are permanent: files are removed outright, not sent to Obsidian's deleted-files folder or the system recycle bin. Back up your vault, or keep it under version control, before giving an AI client write access.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.
Zotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to list, read, search, create, update, rename, and delete markdown notes in a local Obsidian vault via an HTTP MCP endpoint.1MIT
- FlicenseNot gradedqualityCmaintenanceEnables local MCP clients to list, read, write, and search notes in an Obsidian vault via an HTTP server running inside Obsidian.1-
- AlicenseAqualityBmaintenanceEnables MCP clients to safely read, search, create, edit, delete, and move notes in an Obsidian vault, with automatic link repair and reversible deletes.10MIT
- FlicenseNot gradedqualityCmaintenanceEnables MCP clients to search, read, list, and append to markdown notes in a local Obsidian vault or folder of .md files.-