obsidian-mcp
Provides read-only tools for interacting with an Obsidian vault, including listing notes, searching note contents, reading individual notes, and listing tags.
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-mcp
A Model Context Protocol server that exposes an Obsidian (Markdown) vault to any MCP client (Claude Desktop, Claude Code, Cursor). Ask your assistant to search your notes, read a specific note, or list your tags, and it queries the vault directly through typed MCP tools.
Tools
Tool | Description |
| List every Markdown note as vault-relative paths |
| Case-insensitive substring search; returns |
| Read one note by its vault-relative path |
| Every tag in the vault with its count, from frontmatter and inline |
All tools are read-only and refuse any path outside the vault root.
Related MCP server: vault-mcp-bridge
Install
git clone https://github.com/<your-username>/obsidian-mcp.git
cd obsidian-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"Configure in an MCP client
Point the client at the server and set VAULT_PATH to your vault root. Example for Claude Desktop (claude_desktop_config.json) or Claude Code:
{
"mcpServers": {
"obsidian": {
"command": "obsidian-mcp",
"env": { "VAULT_PATH": "/absolute/path/to/your/vault" }
}
}
}Restart the client. Ask it: "search my vault for retrieval" or "list my tags."
Develop
pytest # run the unit tests
VAULT_PATH=/path/to/vault obsidian-mcp # run the server on stdioThe core vault logic lives in src/obsidian_mcp/vault.py (pure functions, fully unit-tested) and is kept separate from the MCP wiring in server.py, so the logic can be tested without an MCP client.
Roadmap
Write tools (append to a note, create from template) behind an opt-in flag
Expose notes as MCP resources and add reusable prompts
Streamable-HTTP transport for remote use
Tag-filtered and frontmatter-field search
License
MIT
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
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Read-only search and Markdown access to liz's public docs, prompts, resources, and an MCP App.
Encrypted Markdown notes and team knowledge base. Search, read and write notes in vaults you allow.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides read-only access to an Obsidian vault, enabling file listing, content reading, and text search across notes via MCP.42Apache 2.0
- AlicenseNot gradedqualityDmaintenanceRead-only MCP bridge that exposes secure search and fetch tools over an Obsidian-compatible Markdown vault, enabling ChatGPT to query notes without write access.1Apache 2.0
- AlicenseAqualityDmaintenanceEnables MCP clients to search and read notes from an Obsidian or markdown vault through four governed tools, with enforced read-only access, a page budget, and path sandboxing.43 npm1MIT
- FlicenseNot gradedqualityCmaintenanceEnables MCP clients to search, read, list, and append to markdown notes in a local Obsidian vault or folder of .md files.-