Exposes an Obsidian vault to AI assistants, enabling operations such as reading, writing, searching, and managing notes, tags, frontmatter, and links.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-obsidiansearch my notes for 'marketing strategy' and summarize the latest one"
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.
mcp-obsidian
An MCP server that exposes your Obsidian vault to AI assistants via the Model Context Protocol.
Requirements
Python 3.12+
Installation
git clone https://github.com/johnkang/mcp-obsidian
cd mcp-obsidian
uv syncUsage
Set the OBSIDIAN_VAULT_PATH environment variable to the absolute path of your vault, then run the server:
OBSIDIAN_VAULT_PATH=/path/to/your/vault uv run mcp-obsidianClaude Desktop Integration
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"obsidian": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-obsidian", "mcp-obsidian"],
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
}
}
}
}The config file is located at:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Tools
File Operations
Tool | Description |
| List files and folders in the vault or a subdirectory |
| Read the contents of a note |
| Create or overwrite a note (parent dirs created automatically) |
| Append content to the end of an existing note |
| Delete a note or folder |
| Move or rename a note within the vault |
Search
Tool | Description |
| Case-insensitive full-text search across all |
| Find all notes containing a specific tag |
Frontmatter
Tool | Description |
| Read the YAML frontmatter of a note |
| Set or update a frontmatter field (creates it if absent) |
Links & Graph
Tool | Description |
| Find all notes that link to a given note via |
| Extract all |
| Find notes with no incoming or outgoing links |
Daily Notes
Tool | Description |
| Read the daily note for a date (defaults to today, format: |
| Create a daily note, using a daily template from |
Utility
Tool | Description |
| List all tags in the vault with usage counts |
| List the N most recently modified notes |
| Return vault statistics (note count, word count, tags, links) |
| List all templates in the vault's |
Security
All file paths are validated to prevent path traversal attacks — no operation can escape the configured vault directory.
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.