Obsidian MCP
Enables comprehensive management of Obsidian vaults, including full CRUD operations on notes, wikilink and frontmatter management, tag-based searching, and section-level content manipulation.
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
MCP server for Obsidian vault management. Designed for AI agents (Claude Desktop, Claude Code).
Features
Full CRUD operations on notes
Wikilink management (auto-update on rename/delete)
Frontmatter manipulation
Tag-based and content search
Backlinks discovery
Section-level operations
Related MCP server: Obsidian MCP Server
Installation
poetry installConfiguration
Set the vault path via environment variable:
export OBSIDIAN_VAULT_PATH="/path/to/your/obsidian/vault"
# WSL example (Windows vault accessed from WSL)
export OBSIDIAN_VAULT_PATH="/mnt/c/Users/username/Documents/Obsidian/my_vault"Claude Desktop Configuration
Add to claude_desktop_config.json:
Linux/macOS:
{
"mcpServers": {
"obsidian": {
"command": "bash",
"args": ["-c", "cd /path/to/obsidian-mcp && poetry run obs-mcp"],
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
}
}
}
}Windows (via WSL):
{
"mcpServers": {
"obsidian": {
"command": "wsl",
"args": [
"-e", "bash", "-c",
"cd /path/to/obsidian-mcp && poetry run obs-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "/mnt/c/Users/username/Documents/Obsidian/my_vault"
}
}
}
}Available Tools
Tool | Description |
| Read note content (frontmatter + body) |
| Create note |
| Append to note |
| Replace body, preserve frontmatter |
| Delete (links updated to |
| Rename + update wikilinks |
| Search (name, name_partial, content, tag) |
| Get incoming/outgoing links |
| Get frontmatter + links without body |
| Set frontmatter key |
| Add tag to note |
| Remove tag from note |
| List all notes (paginated) |
| Replace text in note |
| Insert text at position |
| Read section by heading |
| Append to section |
| Replace section content |
| Delete section |
| Get all headings |
| Find broken wikilinks |
| Get tool descriptions |
Vault Structure
Flat structure (all
.mdfiles in vault root)YAML frontmatter with
---delimitersWikilinks:
[[Note Name]]Tags in frontmatter:
tags: [tag1, tag2].trash/for deleted notes.obsidian/ignored
Development
# Run tests
poetry run pytest tests/spec/core/ -v
# Lint
poetry run ruff check src/
poetry run mypy src/License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.3,713 npm751MIT
- AlicenseAqualityCmaintenanceEnables AI agents to explore, search, and manage local Obsidian vault documents with tools for document search, automatic frontmatter property generation, and attachment organization.5205 npm2ISC
- AlicenseAqualityDmaintenanceEnables comprehensive management of Obsidian vaults with full CRUD operations, advanced search, link/tag extraction, backlinks discovery, frontmatter editing, and template-based note creation through natural language.16MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to read, write, search, and navigate Obsidian vault notes with support for CRUD operations, full-text search, graph navigation, daily notes, and frontmatter management.3,713 npm-